@credal/sdk 0.0.30 → 0.1.0

package/dist/esm/errors/CredalError.d.mts

@@ -0,0 +1,15 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as core from "../core/index.mjs";
+export declare class CredalError extends Error {
+    readonly statusCode?: number;
+    readonly body?: unknown;
+    readonly rawResponse?: core.RawResponse;
+    constructor({ message, statusCode, body, rawResponse, }: {
+        message?: string;
+        statusCode?: number;
+        body?: unknown;
+        rawResponse?: core.RawResponse;
+    });
+}

package/dist/esm/errors/CredalError.mjs

@@ -0,0 +1,26 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import { toJson } from "../core/json.mjs";
+export class CredalError extends Error {
+    constructor({ message, statusCode, body, rawResponse, }) {
+        super(buildMessage({ message, statusCode, body }));
+        Object.setPrototypeOf(this, CredalError.prototype);
+        this.statusCode = statusCode;
+        this.body = body;
+        this.rawResponse = rawResponse;
+    }
+}
+function buildMessage({ message, statusCode, body, }) {
+    let lines = [];
+    if (message != null) {
+        lines.push(message);
+    }
+    if (statusCode != null) {
+        lines.push(`Status code: ${statusCode.toString()}`);
+    }
+    if (body != null) {
+        lines.push(`Body: ${toJson(body, undefined, 2)}`);
+    }
+    return lines.join("\n");
+}

package/dist/esm/errors/CredalTimeoutError.mjs

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export class CredalTimeoutError extends Error {
+    constructor(message) {
+        super(message);
+        Object.setPrototypeOf(this, CredalTimeoutError.prototype);
+    }
+}

package/dist/esm/errors/index.d.mts

@@ -0,0 +1,2 @@
+export { CredalError } from "./CredalError.mjs";
+export { CredalTimeoutError } from "./CredalTimeoutError.mjs";

package/dist/esm/errors/index.mjs

@@ -0,0 +1,2 @@
+export { CredalError } from "./CredalError.mjs";
+export { CredalTimeoutError } from "./CredalTimeoutError.mjs";

package/dist/esm/index.d.mts

@@ -0,0 +1,4 @@
+export * as Credal from "./api/index.mjs";
+export { CredalError, CredalTimeoutError } from "./errors/index.mjs";
+export { CredalClient } from "./Client.mjs";
+export { CredalEnvironment } from "./environments.mjs";

package/dist/esm/index.mjs

@@ -0,0 +1,4 @@
+export * as Credal from "./api/index.mjs";
+export { CredalError, CredalTimeoutError } from "./errors/index.mjs";
+export { CredalClient } from "./Client.mjs";
+export { CredalEnvironment } from "./environments.mjs";

package/dist/esm/version.d.mts

@@ -0,0 +1 @@
+export declare const SDK_VERSION = "0.1.0";

package/dist/esm/version.mjs

@@ -0,0 +1 @@
+export const SDK_VERSION = "0.1.0";

package/package.json

@@ -1,36 +1,52 @@
 {
     "name": "@credal/sdk",
-    "version": "0.0.30",
+    "version": "0.1.0",
     "private": false,
-    "repository": "https://github.com/credal-ai/credal-typescript-sdk",
-    "main": "./index.js",
-    "types": "./index.d.ts",
+    "repository": "github:credal-ai/credal-typescript-sdk",
+    "type": "commonjs",
+    "main": "./dist/cjs/index.js",
+    "module": "./dist/esm/index.mjs",
+    "types": "./dist/cjs/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/cjs/index.d.ts",
+            "import": {
+                "types": "./dist/esm/index.d.mts",
+                "default": "./dist/esm/index.mjs"
+            },
+            "require": {
+                "types": "./dist/cjs/index.d.ts",
+                "default": "./dist/cjs/index.js"
+            },
+            "default": "./dist/cjs/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist",
+        "reference.md",
+        "README.md",
+        "LICENSE"
+    ],
     "scripts": {
         "format": "prettier . --write --ignore-unknown",
-        "build": "tsc",
-        "prepack": "cp -rv dist/. .",
-        "test": "jest"
-    },
-    "dependencies": {
-        "url-join": "4.0.1",
-        "form-data": "^4.0.0",
-        "formdata-node": "^6.0.3",
-        "node-fetch": "^2.7.0",
-        "qs": "^6.13.1",
-        "readable-stream": "^4.5.2",
-        "js-base64": "3.7.7"
+        "build": "yarn build:cjs && yarn build:esm",
+        "build:cjs": "tsc --project ./tsconfig.cjs.json",
+        "build:esm": "tsc --project ./tsconfig.esm.json && node scripts/rename-to-esm-files.js dist/esm",
+        "test": "jest --config jest.config.mjs",
+        "test:unit": "jest --selectProjects unit",
+        "test:browser": "jest --selectProjects browser",
+        "test:wire": "jest --selectProjects wire"
     },
     "devDependencies": {
-        "@types/url-join": "4.0.1",
-        "@types/qs": "^6.9.17",
-        "@types/node-fetch": "^2.6.12",
-        "@types/readable-stream": "^4.0.18",
         "webpack": "^5.97.1",
         "ts-loader": "^9.5.1",
         "jest": "^29.7.0",
+        "@jest/globals": "^29.7.0",
         "@types/jest": "^29.5.14",
-        "ts-jest": "^29.1.1",
+        "ts-jest": "^29.3.4",
         "jest-environment-jsdom": "^29.7.0",
+        "msw": "^2.8.4",
         "@types/node": "^18.19.70",
         "prettier": "^3.4.2",
         "typescript": "~5.7.2"
@@ -38,7 +54,12 @@
     "browser": {
         "fs": false,
         "os": false,
-        "path": false
+        "path": false,
+        "stream": false
+    },
+    "packageManager": "yarn@1.22.22",
+    "engines": {
+        "node": ">=18.0.0"
     },
-    "packageManager": "yarn@1.22.22"
+    "sideEffects": false
 }

package/reference.md

@@ -1129,7 +1129,7 @@ Credal lets you easily sync your MongoDB data for use in Collections and Agents.
 
 ```typescript
 await client.documentCollections.createMongoCollectionSync({
-    mongoUri: "mongodb+srv://cluster0.hzwklqn.mongodb.net/Cluster0?retryWrites=true&w=majority",
+    mongoURI: "mongodb+srv://cluster0.hzwklqn.mongodb.net/Cluster0?retryWrites=true&w=majority",
     collectionId: "ac20e6ba-0bae-11ef-b25a-efca73df4c3a",
     config: {
         syncName: "My sales transcripts",
@@ -1210,7 +1210,7 @@ Credal lets you easily sync your MongoDB data for use in Collections and Agents.
 
 ```typescript
 await client.documentCollections.updateMongoCollectionSync({
-    mongoUri: "mongodb+srv://cluster0.hzwklqn.mongodb.net/Cluster0?retryWrites=true&w=majority",
+    mongoURI: "mongodb+srv://cluster0.hzwklqn.mongodb.net/Cluster0?retryWrites=true&w=majority",
     mongoCredentialId: "5988ed76-6ee1-11ef-97dd-1fca54b7c4bc",
     config: {
         syncName: "My recent summarized sales transcripts",

package/Client.d.ts

@@ -1,46 +0,0 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as environments from "./environments";
-import * as core from "./core";
-import { Copilots } from "./api/resources/copilots/client/Client";
-import { DocumentCatalog } from "./api/resources/documentCatalog/client/Client";
-import { DocumentCollections } from "./api/resources/documentCollections/client/Client";
-import { PermissionsService } from "./api/resources/permissionsService/client/Client";
-import { Search } from "./api/resources/search/client/Client";
-import { Users } from "./api/resources/users/client/Client";
-export declare namespace CredalClient {
-    interface Options {
-        environment?: core.Supplier<environments.CredalEnvironment | string>;
-        /** Specify a custom URL to connect the client to. */
-        baseUrl?: core.Supplier<string>;
-        apiKey?: core.Supplier<core.BearerToken | undefined>;
-        fetcher?: core.FetchFunction;
-    }
-    interface RequestOptions {
-        /** The maximum time to wait for a response in seconds. */
-        timeoutInSeconds?: number;
-        /** The number of times to retry the request. Defaults to 2. */
-        maxRetries?: number;
-        /** A hook to abort the request. */
-        abortSignal?: AbortSignal;
-        /** Additional headers to include in the request. */
-        headers?: Record<string, string>;
-    }
-}
-export declare class CredalClient {
-    protected readonly _options: CredalClient.Options;
-    protected _copilots: Copilots | undefined;
-    protected _documentCatalog: DocumentCatalog | undefined;
-    protected _documentCollections: DocumentCollections | undefined;
-    protected _permissionsService: PermissionsService | undefined;
-    protected _search: Search | undefined;
-    protected _users: Users | undefined;
-    constructor(_options?: CredalClient.Options);
-    get copilots(): Copilots;
-    get documentCatalog(): DocumentCatalog;
-    get documentCollections(): DocumentCollections;
-    get permissionsService(): PermissionsService;
-    get search(): Search;
-    get users(): Users;
-}

package/Client.js

@@ -1,42 +0,0 @@
-"use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CredalClient = void 0;
-const Client_1 = require("./api/resources/copilots/client/Client");
-const Client_2 = require("./api/resources/documentCatalog/client/Client");
-const Client_3 = require("./api/resources/documentCollections/client/Client");
-const Client_4 = require("./api/resources/permissionsService/client/Client");
-const Client_5 = require("./api/resources/search/client/Client");
-const Client_6 = require("./api/resources/users/client/Client");
-class CredalClient {
-    constructor(_options = {}) {
-        this._options = _options;
-    }
-    get copilots() {
-        var _a;
-        return ((_a = this._copilots) !== null && _a !== void 0 ? _a : (this._copilots = new Client_1.Copilots(this._options)));
-    }
-    get documentCatalog() {
-        var _a;
-        return ((_a = this._documentCatalog) !== null && _a !== void 0 ? _a : (this._documentCatalog = new Client_2.DocumentCatalog(this._options)));
-    }
-    get documentCollections() {
-        var _a;
-        return ((_a = this._documentCollections) !== null && _a !== void 0 ? _a : (this._documentCollections = new Client_3.DocumentCollections(this._options)));
-    }
-    get permissionsService() {
-        var _a;
-        return ((_a = this._permissionsService) !== null && _a !== void 0 ? _a : (this._permissionsService = new Client_4.PermissionsService(this._options)));
-    }
-    get search() {
-        var _a;
-        return ((_a = this._search) !== null && _a !== void 0 ? _a : (this._search = new Client_5.Search(this._options)));
-    }
-    get users() {
-        var _a;
-        return ((_a = this._users) !== null && _a !== void 0 ? _a : (this._users = new Client_6.Users(this._options)));
-    }
-}
-exports.CredalClient = CredalClient;

package/api/index.d.ts

@@ -1 +0,0 @@
-export * from "./resources";

package/api/index.js

@@ -1,17 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./resources"), exports);

package/api/resources/common/index.d.ts

@@ -1 +0,0 @@
-export * from "./types";

package/api/resources/common/index.js

@@ -1,17 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./types"), exports);

package/api/resources/common/types/Collaborator.d.ts

@@ -1,8 +0,0 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as Credal from "../../../index";
-export interface Collaborator {
-    email: string;
-    role: Credal.Role;
-}

package/api/resources/common/types/ExternalResourceId.d.ts

@@ -1,8 +0,0 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as Credal from "../../../index";
-export interface ExternalResourceId {
-    externalResourceId: string;
-    resourceType: Credal.ResourceType;
-}

package/api/resources/common/types/ResourceIdentifier.d.ts

@@ -1,13 +0,0 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as Credal from "../../../index";
-export type ResourceIdentifier = Credal.ResourceIdentifier.ExternalResourceId | Credal.ResourceIdentifier.Url;
-export declare namespace ResourceIdentifier {
-    interface ExternalResourceId extends Credal.ExternalResourceId {
-        type: "external-resource-id";
-    }
-    interface Url extends Credal.Url {
-        type: "url";
-    }
-}

package/api/resources/common/types/index.d.ts

@@ -1,7 +0,0 @@
-export * from "./ResourceIdentifier";
-export * from "./ExternalResourceId";
-export * from "./Url";
-export * from "./ResourceType";
-export * from "./Collaborator";
-export * from "./Role";
-export * from "./Operator";

package/api/resources/common/types/index.js

@@ -1,23 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./ResourceIdentifier"), exports);
-__exportStar(require("./ExternalResourceId"), exports);
-__exportStar(require("./Url"), exports);
-__exportStar(require("./ResourceType"), exports);
-__exportStar(require("./Collaborator"), exports);
-__exportStar(require("./Role"), exports);
-__exportStar(require("./Operator"), exports);

package/api/resources/copilots/client/Client.d.ts

@@ -1,166 +0,0 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as environments from "../../../../environments";
-import * as core from "../../../../core";
-import * as Credal from "../../../index";
-export declare namespace Copilots {
-    interface Options {
-        environment?: core.Supplier<environments.CredalEnvironment | string>;
-        /** Specify a custom URL to connect the client to. */
-        baseUrl?: core.Supplier<string>;
-        apiKey?: core.Supplier<core.BearerToken | undefined>;
-        fetcher?: core.FetchFunction;
-    }
-    interface RequestOptions {
-        /** The maximum time to wait for a response in seconds. */
-        timeoutInSeconds?: number;
-        /** The number of times to retry the request. Defaults to 2. */
-        maxRetries?: number;
-        /** A hook to abort the request. */
-        abortSignal?: AbortSignal;
-        /** Additional headers to include in the request. */
-        headers?: Record<string, string>;
-    }
-}
-export declare class Copilots {
-    protected readonly _options: Copilots.Options;
-    constructor(_options?: Copilots.Options);
-    /**
-     * Create a new agent. The API key used will be added to the agent for future Requests
-     *
-     * @param {Credal.CreateCopilotRequest} request
-     * @param {Copilots.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @example
-     *     await client.copilots.createCopilot({
-     *         name: "Customer Agent",
-     *         description: "This agent is used to answer customer requests based on internal documentation.",
-     *         collaborators: [{
-     *                 email: "test@gmail.com",
-     *                 role: "editor"
-     *             }]
-     *     })
-     */
-    createCopilot(request: Credal.CreateCopilotRequest, requestOptions?: Copilots.RequestOptions): core.HttpResponsePromise<Credal.CreateCopilotResponse>;
-    private __createCopilot;
-    /**
-     * OPTIONAL. Create a new conversation with the Agent. The conversation ID can be used in the `sendMessage` endpoint. The `sendMessage` endpoint automatically creates new conversations upon first request, but calling this endpoint can simplify certain use cases where it is helpful for the application to have the conversation ID before the first message is sent.
-     *
-     * @param {Credal.CreateConversationRequest} request
-     * @param {Copilots.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @example
-     *     await client.copilots.createConversation({
-     *         agentId: "82e4b12a-6990-45d4-8ebd-85c00e030c24",
-     *         userEmail: "ravin@credal.ai"
-     *     })
-     */
-    createConversation(request: Credal.CreateConversationRequest, requestOptions?: Copilots.RequestOptions): core.HttpResponsePromise<Credal.CreateConversationResponse>;
-    private __createConversation;
-    /**
-     * @param {Credal.ProvideMessageFeedbackRequest} request
-     * @param {Copilots.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @example
-     *     await client.copilots.provideMessageFeedback({
-     *         userEmail: "ravin@credal.ai",
-     *         messageId: "dd721cd8-4bf2-4b94-9869-258df3dab9dc",
-     *         agentId: "82e4b12a-6990-45d4-8ebd-85c00e030c24",
-     *         messageFeedback: {
-     *             feedback: "NEGATIVE",
-     *             suggestedAnswer: "Yes, Credal is SOC 2 compliant.",
-     *             descriptiveFeedback: "The response should be extremely clear and concise."
-     *         }
-     *     })
-     */
-    provideMessageFeedback(request: Credal.ProvideMessageFeedbackRequest, requestOptions?: Copilots.RequestOptions): core.HttpResponsePromise<void>;
-    private __provideMessageFeedback;
-    /**
-     * @param {Credal.SendMessageRequest} request
-     * @param {Copilots.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @example
-     *     await client.copilots.sendMessage({
-     *         agentId: "82e4b12a-6990-45d4-8ebd-85c00e030c24",
-     *         message: "Is Credal SOC 2 compliant?",
-     *         userEmail: "ravin@credal.ai",
-     *         inputVariables: [{
-     *                 name: "input1",
-     *                 ids: ["82e4b12a-6990-45d4-8ebd-85c00e030c24"]
-     *             }, {
-     *                 name: "input2",
-     *                 ids: ["82e4b12a-6990-45d4-8ebd-85c00e030c25", "82e4b12a-6990-45d4-8ebd-85c00e030c26"]
-     *             }]
-     *     })
-     */
-    sendMessage(request: Credal.SendMessageRequest, requestOptions?: Copilots.RequestOptions): core.HttpResponsePromise<Credal.SendAgentMessageResponse>;
-    private __sendMessage;
-    /**
-     * This endpoint allows you to send a message to a specific agent and get the response back as a streamed set of Server-Sent Events.
-     */
-    streamMessage(request: Credal.StreamMessageRequest, requestOptions?: Copilots.RequestOptions): core.HttpResponsePromise<core.Stream<Credal.StreamingChunk>>;
-    private __streamMessage;
-    /**
-     * Link a collection with a agent. The API Key used must be added to both the collection and the agent beforehand.
-     *
-     * @param {Credal.AddCollectionToCopilotRequest} request
-     * @param {Copilots.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @example
-     *     await client.copilots.addCollectionToCopilot({
-     *         copilotId: "82e4b12a-6990-45d4-8ebd-85c00e030c24",
-     *         collectionId: "def1055f-83c5-43d6-b558-f7a38e7b299e"
-     *     })
-     */
-    addCollectionToCopilot(request: Credal.AddCollectionToCopilotRequest, requestOptions?: Copilots.RequestOptions): core.HttpResponsePromise<void>;
-    private __addCollectionToCopilot;
-    /**
-     * Unlink a collection with a agent. The API Key used must be added to both the collection and the agent beforehand.
-     *
-     * @param {Credal.RemoveCollectionFromCopilotRequest} request
-     * @param {Copilots.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @example
-     *     await client.copilots.removeCollectionFromCopilot({
-     *         copilotId: "82e4b12a-6990-45d4-8ebd-85c00e030c24",
-     *         collectionId: "def1055f-83c5-43d6-b558-f7a38e7b299e"
-     *     })
-     */
-    removeCollectionFromCopilot(request: Credal.RemoveCollectionFromCopilotRequest, requestOptions?: Copilots.RequestOptions): core.HttpResponsePromise<void>;
-    private __removeCollectionFromCopilot;
-    /**
-     * Update the configuration for a agent
-     *
-     * @param {Credal.UpdateConfigurationRequest} request
-     * @param {Copilots.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @example
-     *     await client.copilots.updateConfiguration({
-     *         copilotId: "82e4b12a-6990-45d4-8ebd-85c00e030c24",
-     *         configuration: {
-     *             name: "Customer Agent",
-     *             description: "This agent is used to answer customer requests based on internal documentation.",
-     *             prompt: "You are a polite, helpful assistant used to answer customer requests.",
-     *             aiEndpointConfiguration: {
-     *                 baseUrl: "https://api.openai.com/v1/",
-     *                 apiKey: "<YOUR_API_KEY_HERE>"
-     *             }
-     *         }
-     *     })
-     */
-    updateConfiguration(request: Credal.UpdateConfigurationRequest, requestOptions?: Copilots.RequestOptions): core.HttpResponsePromise<void>;
-    private __updateConfiguration;
-    /**
-     * @param {Credal.DeleteCopilotRequest} request
-     * @param {Copilots.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @example
-     *     await client.copilots.deleteCopilot({
-     *         id: "ac20e6ba-0bae-11ef-b25a-efca73df4c3a"
-     *     })
-     */
-    deleteCopilot(request: Credal.DeleteCopilotRequest, requestOptions?: Copilots.RequestOptions): core.HttpResponsePromise<Credal.DeleteCopilotResponse>;
-    private __deleteCopilot;
-    protected _getAuthorizationHeader(): Promise<string>;
-}