@inconvoai/node 0.0.1-alpha.1

package/src/internal/utils/values.ts

@@ -0,0 +1,105 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { InconvoError } from '../../core/error';
+
+// https://url.spec.whatwg.org/#url-scheme-string
+const startsWithSchemeRegexp = /^[a-z][a-z0-9+.-]*:/i;
+
+export const isAbsoluteURL = (url: string): boolean => {
+  return startsWithSchemeRegexp.test(url);
+};
+
+export let isArray = (val: unknown): val is unknown[] => ((isArray = Array.isArray), isArray(val));
+export let isReadonlyArray = isArray as (val: unknown) => val is readonly unknown[];
+
+/** Returns an object if the given value isn't an object, otherwise returns as-is */
+export function maybeObj(x: unknown): object {
+  if (typeof x !== 'object') {
+    return {};
+  }
+
+  return x ?? {};
+}
+
+// https://stackoverflow.com/a/34491287
+export function isEmptyObj(obj: Object | null | undefined): boolean {
+  if (!obj) return true;
+  for (const _k in obj) return false;
+  return true;
+}
+
+// https://eslint.org/docs/latest/rules/no-prototype-builtins
+export function hasOwn<T extends object = object>(obj: T, key: PropertyKey): key is keyof T {
+  return Object.prototype.hasOwnProperty.call(obj, key);
+}
+
+export function isObj(obj: unknown): obj is Record<string, unknown> {
+  return obj != null && typeof obj === 'object' && !Array.isArray(obj);
+}
+
+export const ensurePresent = <T>(value: T | null | undefined): T => {
+  if (value == null) {
+    throw new InconvoError(`Expected a value to be given but received ${value} instead.`);
+  }
+
+  return value;
+};
+
+export const validatePositiveInteger = (name: string, n: unknown): number => {
+  if (typeof n !== 'number' || !Number.isInteger(n)) {
+    throw new InconvoError(`${name} must be an integer`);
+  }
+  if (n < 0) {
+    throw new InconvoError(`${name} must be a positive integer`);
+  }
+  return n;
+};
+
+export const coerceInteger = (value: unknown): number => {
+  if (typeof value === 'number') return Math.round(value);
+  if (typeof value === 'string') return parseInt(value, 10);
+
+  throw new InconvoError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+};
+
+export const coerceFloat = (value: unknown): number => {
+  if (typeof value === 'number') return value;
+  if (typeof value === 'string') return parseFloat(value);
+
+  throw new InconvoError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+};
+
+export const coerceBoolean = (value: unknown): boolean => {
+  if (typeof value === 'boolean') return value;
+  if (typeof value === 'string') return value === 'true';
+  return Boolean(value);
+};
+
+export const maybeCoerceInteger = (value: unknown): number | undefined => {
+  if (value === undefined) {
+    return undefined;
+  }
+  return coerceInteger(value);
+};
+
+export const maybeCoerceFloat = (value: unknown): number | undefined => {
+  if (value === undefined) {
+    return undefined;
+  }
+  return coerceFloat(value);
+};
+
+export const maybeCoerceBoolean = (value: unknown): boolean | undefined => {
+  if (value === undefined) {
+    return undefined;
+  }
+  return coerceBoolean(value);
+};
+
+export const safeJSON = (text: string) => {
+  try {
+    return JSON.parse(text);
+  } catch (err) {
+    return undefined;
+  }
+};

package/src/internal/utils.ts

@@ -0,0 +1,8 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './utils/values';
+export * from './utils/base64';
+export * from './utils/env';
+export * from './utils/log';
+export * from './utils/uuid';
+export * from './utils/sleep';

package/src/lib/.keep

@@ -0,0 +1,4 @@
+File generated from our OpenAPI spec by Stainless.
+
+This directory can be used to store custom files to expand the SDK.
+It is ignored by Stainless code generation and its content (other than this keep file) won't be touched.

package/src/pagination.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/pagination instead */
+export * from './core/pagination';

package/src/resource.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/resource instead */
+export * from './core/resource';

package/src/resources/conversations/conversations.ts

@@ -0,0 +1,122 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ResponseAPI from './response/response';
+import { Chart, Response, ResponseCreateParams, ResponseCreateResponse, Table } from './response/response';
+import { APIPromise } from '../../core/api-promise';
+import { ConversationsCursor, type ConversationsCursorParams, PagePromise } from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Conversations extends APIResource {
+  response: ResponseAPI.Response = new ResponseAPI.Response(this._client);
+
+  /**
+   * Create conversation
+   */
+  create(body: ConversationCreateParams, options?: RequestOptions): APIPromise<ConversationCreateResponse> {
+    return this._client.post('/conversations', { body, ...options });
+  }
+
+  /**
+   * Retrieve conversation
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<InconvoConversation> {
+    return this._client.get(path`/conversations/${id}`, options);
+  }
+
+  /**
+   * List conversations
+   */
+  list(
+    query: ConversationListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ConversationListResponsesConversationsCursor, ConversationListResponse> {
+    return this._client.getAPIList('/conversations', ConversationsCursor<ConversationListResponse>, {
+      query,
+      ...options,
+    });
+  }
+}
+
+export type ConversationListResponsesConversationsCursor = ConversationsCursor<ConversationListResponse>;
+
+export interface InconvoConversation {
+  id: string;
+
+  context: { [key: string]: string | number };
+
+  messages: Array<InconvoConversation.Message>;
+}
+
+export namespace InconvoConversation {
+  export interface Message {
+    message: string;
+
+    type: 'text' | 'chart' | 'table';
+
+    /**
+     * Present on Inconvo responses only
+     */
+    id?: string;
+
+    chart?: ResponseAPI.Chart;
+
+    table?: ResponseAPI.Table;
+  }
+}
+
+export interface ConversationCreateResponse {
+  id?: string;
+}
+
+export interface ConversationListResponse {
+  id: string;
+
+  createdAt: string;
+
+  requestContext: { [key: string]: string | number };
+
+  title: string;
+}
+
+export interface ConversationCreateParams {
+  /**
+   * Context key-values used for tenancy / filtering.
+   */
+  context: { [key: string]: unknown };
+}
+
+export interface ConversationListParams extends ConversationsCursorParams {
+  context?: ConversationListParams.Context;
+}
+
+export namespace ConversationListParams {
+  export interface Context {
+    /**
+     * Filter by arbitrary context key/value.
+     */
+    '{key}'?: string | number;
+  }
+}
+
+Conversations.Response = Response;
+
+export declare namespace Conversations {
+  export {
+    type InconvoConversation as InconvoConversation,
+    type ConversationCreateResponse as ConversationCreateResponse,
+    type ConversationListResponse as ConversationListResponse,
+    type ConversationListResponsesConversationsCursor as ConversationListResponsesConversationsCursor,
+    type ConversationCreateParams as ConversationCreateParams,
+    type ConversationListParams as ConversationListParams,
+  };
+
+  export {
+    Response as Response,
+    type Chart as Chart,
+    type Table as Table,
+    type ResponseCreateResponse as ResponseCreateResponse,
+    type ResponseCreateParams as ResponseCreateParams,
+  };
+}

package/src/resources/conversations/index.ts

@@ -0,0 +1,18 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Conversations,
+  type InconvoConversation,
+  type ConversationCreateResponse,
+  type ConversationListResponse,
+  type ConversationCreateParams,
+  type ConversationListParams,
+  type ConversationListResponsesConversationsCursor,
+} from './conversations';
+export {
+  Response,
+  type Chart,
+  type Table,
+  type ResponseCreateResponse,
+  type ResponseCreateParams,
+} from './response/index';

package/src/resources/conversations/response/feedback.ts

@@ -0,0 +1,85 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class FeedbackResource extends APIResource {
+  /**
+   * Create feedback
+   */
+  create(responseID: string, params: FeedbackCreateParams, options?: RequestOptions): APIPromise<Feedback> {
+    const { id, ...body } = params;
+    return this._client.post(path`/conversations/${id}/response/${responseID}/feedback`, {
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Update feedback
+   */
+  update(feedbackID: string, params: FeedbackUpdateParams, options?: RequestOptions): APIPromise<Feedback> {
+    const { id, response_id, ...body } = params;
+    return this._client.patch(path`/conversations/${id}/response/${response_id}/feedback/${feedbackID}`, {
+      body,
+      ...options,
+    });
+  }
+}
+
+export interface Feedback {
+  id: string;
+
+  rating: 'positive' | 'negative';
+
+  comment?: string;
+}
+
+export interface FeedbackCreateParams {
+  /**
+   * Path param:
+   */
+  id: string;
+
+  /**
+   * Body param:
+   */
+  rating: 'positive' | 'negative';
+
+  /**
+   * Body param:
+   */
+  comment?: string;
+}
+
+export interface FeedbackUpdateParams {
+  /**
+   * Path param:
+   */
+  id: string;
+
+  /**
+   * Path param:
+   */
+  response_id: string;
+
+  /**
+   * Body param:
+   */
+  comment?: string;
+
+  /**
+   * Body param:
+   */
+  rating?: 'positive' | 'negative';
+}
+
+export declare namespace FeedbackResource {
+  export {
+    type Feedback as Feedback,
+    type FeedbackCreateParams as FeedbackCreateParams,
+    type FeedbackUpdateParams as FeedbackUpdateParams,
+  };
+}

package/src/resources/conversations/response/index.ts

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  FeedbackResource,
+  type Feedback,
+  type FeedbackCreateParams,
+  type FeedbackUpdateParams,
+} from './feedback';
+export {
+  Response,
+  type Chart,
+  type Table,
+  type ResponseCreateResponse,
+  type ResponseCreateParams,
+} from './response';

package/src/resources/conversations/response/response.ts

@@ -0,0 +1,124 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as FeedbackAPI from './feedback';
+import { Feedback, FeedbackCreateParams, FeedbackResource, FeedbackUpdateParams } from './feedback';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+import { SSEStream, createSSEStream } from '../../../core/sse-stream';
+
+export class Response extends APIResource {
+  feedback: FeedbackAPI.FeedbackResource = new FeedbackAPI.FeedbackResource(this._client);
+
+  /**
+   * Create response (sync or streamed)
+   */
+  create(
+    id: string,
+    body: ResponseCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<ResponseCreateResponse>;
+  create(
+    id: string,
+    body: ResponseCreateParams & { stream?: false },
+    options?: RequestOptions,
+  ): APIPromise<ResponseCreateResponse>;
+  create(id: string, body: ResponseCreateParams & { stream: true }, options?: RequestOptions): SSEStream;
+  create(
+    id: string,
+    body: ResponseCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<ResponseCreateResponse> | SSEStream {
+    if (body.stream === true) {
+      return this._createStreaming(id, body, options);
+    }
+    return this._client.post(path`/conversations/${id}/response`, { body, ...options });
+  }
+
+  private _createStreaming(id: string, body: ResponseCreateParams, options?: RequestOptions): SSEStream {
+    // Create a controller for aborting the request if needed
+    const controller =
+      (globalThis as any).AbortController ? new (globalThis as any).AbortController() : undefined;
+
+    const requestOptions = {
+      ...options,
+      headers: {
+        ...options?.headers,
+        Accept: 'text/event-stream',
+      },
+      signal: controller?.signal,
+      __binaryResponse: true,
+    };
+
+    // When __binaryResponse is true, post() returns the raw Response directly
+    const responsePromise = this._client.post(path`/conversations/${id}/response`, {
+      body,
+      ...requestOptions,
+    }) as Promise<globalThis.Response>;
+
+    return createSSEStream(responsePromise, controller);
+  }
+}
+
+export interface Chart {
+  data: Array<Chart.Data>;
+
+  type: 'line' | 'bar';
+}
+
+export namespace Chart {
+  export interface Data {
+    label: string;
+
+    value: number;
+  }
+}
+
+export interface Table {
+  body: Array<Array<string>>;
+
+  head: Array<string>;
+}
+
+export interface ResponseCreateResponse {
+  id: string;
+
+  conversationId: string;
+
+  message: string;
+
+  type: 'text' | 'chart' | 'table';
+
+  chart?: Chart;
+
+  table?: Table;
+}
+
+export interface ResponseCreateParams {
+  message: string;
+
+  /**
+   * If true and the client sets `Accept: text/event-stream`, the API returns an SSE
+   * stream instead of a single JSON body.
+   */
+  stream?: boolean;
+}
+
+Response.FeedbackResource = FeedbackResource;
+
+export declare namespace Response {
+  export {
+    type Chart as Chart,
+    type Table as Table,
+    type ResponseCreateResponse as ResponseCreateResponse,
+    type ResponseCreateParams as ResponseCreateParams,
+  };
+
+  export {
+    FeedbackResource as FeedbackResource,
+    type Feedback as Feedback,
+    type FeedbackCreateParams as FeedbackCreateParams,
+    type FeedbackUpdateParams as FeedbackUpdateParams,
+  };
+}

package/src/resources/conversations/response.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './response/index';

package/src/resources/conversations.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './conversations/index';

package/src/resources/index.ts

@@ -0,0 +1,11 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Conversations,
+  type InconvoConversation,
+  type ConversationCreateResponse,
+  type ConversationListResponse,
+  type ConversationCreateParams,
+  type ConversationListParams,
+  type ConversationListResponsesConversationsCursor,
+} from './conversations/conversations';

package/src/resources.ts

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

package/src/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  // this config is included in the published src directory to prevent TS errors
+  // from appearing when users go to source, and VSCode opens the source .ts file
+  // via declaration maps
+  "include": ["index.ts"],
+  "compilerOptions": {
+    "target": "ES2015",
+    "lib": ["DOM", "DOM.Iterable", "ES2018"],
+    "moduleResolution": "node"
+  }
+}

package/src/uploads.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/uploads instead */
+export * from './core/uploads';

package/src/version.ts

@@ -0,0 +1 @@
+export const VERSION = '0.0.1-alpha.1'; // x-release-please-version

package/uploads.d.mts

@@ -0,0 +1,2 @@
+export * from "./core/uploads.mjs";
+//# sourceMappingURL=uploads.d.mts.map

package/uploads.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.mts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}

package/uploads.d.ts

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

package/uploads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}

package/uploads.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("./internal/tslib.js");
+/** @deprecated Import from ./core/uploads instead */
+tslib_1.__exportStar(require("./core/uploads.js"), exports);
+//# sourceMappingURL=uploads.js.map

package/uploads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.js","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":";;;AAAA,qDAAqD;AACrD,4DAA+B"}

package/uploads.mjs

@@ -0,0 +1,2 @@
+export * from "./core/uploads.mjs";
+//# sourceMappingURL=uploads.mjs.map

package/uploads.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.mjs","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}

package/version.d.mts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.0.1-alpha.1";
+//# sourceMappingURL=version.d.mts.map

package/version.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,kBAAkB,CAAC"}

package/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.0.1-alpha.1";
+//# sourceMappingURL=version.d.ts.map

package/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,kBAAkB,CAAC"}

package/version.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = void 0;
+exports.VERSION = '0.0.1-alpha.1'; // x-release-please-version
+//# sourceMappingURL=version.js.map

package/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,eAAe,CAAC,CAAC,2BAA2B"}

package/version.mjs

@@ -0,0 +1,2 @@
+export const VERSION = '0.0.1-alpha.1'; // x-release-please-version
+//# sourceMappingURL=version.mjs.map

package/version.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC,CAAC,2BAA2B"}