@dexto/cloud-client 0.0.0-stage → 1.15.0-beta.0

package/dist/index.cjs

@@ -0,0 +1,110 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CloudApiError: () => CloudApiError,
+  createCloudClient: () => createCloudClient,
+  unwrap: () => unwrap
+});
+module.exports = __toCommonJS(index_exports);
+var import_openapi_fetch = __toESM(require("openapi-fetch"), 1);
+var DEXTO_CLOUD_PROJECT_HEADER = "Dexto-Cloud-Project";
+function createCloudClient(options) {
+  const client = (0, import_openapi_fetch.default)({
+    baseUrl: options.apiBaseUrl.replace(/\/+$/u, ""),
+    ...options.fetch === void 0 ? {} : { fetch: options.fetch }
+  });
+  client.use({
+    async onRequest({ request }) {
+      const token = typeof options.token === "string" ? options.token : await options.token();
+      request.headers.set("authorization", `Bearer ${token}`);
+      if (options.cloudProject !== null)
+        request.headers.set(DEXTO_CLOUD_PROJECT_HEADER, options.cloudProject);
+      return request;
+    }
+  });
+  return client;
+}
+var CloudApiError = class extends Error {
+  constructor(input) {
+    super(input.message);
+    __publicField(this, "status");
+    __publicField(this, "code");
+    __publicField(this, "requestId");
+    __publicField(this, "retryable");
+    __publicField(this, "details");
+    this.name = "CloudApiError";
+    this.status = input.status;
+    this.code = input.code;
+    this.requestId = input.requestId;
+    this.retryable = input.retryable;
+    this.details = input.details;
+  }
+};
+async function unwrap(result) {
+  if (result.error === void 0) {
+    if (result.data === void 0) throw errorFor(result.response.status, null);
+    return result.data;
+  }
+  throw errorFor(result.response.status, result.error);
+}
+function errorFor(status, body) {
+  var _a, _b, _c, _d;
+  const envelope = readEnvelope(body);
+  return new CloudApiError({
+    status,
+    code: (_a = envelope == null ? void 0 : envelope.code) != null ? _a : `http_${status}`,
+    message: (_b = envelope == null ? void 0 : envelope.message) != null ? _b : `Dexto answered HTTP ${status}.`,
+    requestId: (_c = envelope == null ? void 0 : envelope.requestId) != null ? _c : null,
+    retryable: (_d = envelope == null ? void 0 : envelope.retryable) != null ? _d : status >= 500,
+    details: envelope == null ? void 0 : envelope.details
+  });
+}
+function readEnvelope(body) {
+  if (typeof body !== "object" || body === null || !("error" in body)) return null;
+  const error = body.error;
+  if (typeof error !== "object" || error === null) return null;
+  const field = (name) => name in error ? Reflect.get(error, name) : void 0;
+  const code = field("code");
+  const message = field("message");
+  if (typeof code !== "string" || typeof message !== "string") return null;
+  const requestId = field("requestId");
+  const retryable = field("retryable");
+  return {
+    code,
+    message,
+    requestId: typeof requestId === "string" ? requestId : null,
+    retryable: retryable === true,
+    details: field("details")
+  };
+}

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+import createClient from 'openapi-fetch';
+import type { paths } from './generated/v1.js';
+export type { paths } from './generated/v1.js';
+export interface CloudClientOptions {
+    /** Such as `https://api.dexto.ai`. */
+    readonly apiBaseUrl: string;
+    /** An API key, or a function asked before every request for a person's fresh access token. */
+    readonly token: string | (() => Promise<string>);
+    /** The Cloud project a person's token acts in; null for a key, which acts in its own. */
+    readonly cloudProject: string | null;
+    readonly fetch?: typeof globalThis.fetch;
+}
+export type CloudClient = ReturnType<typeof createClient<paths>>;
+export declare function createCloudClient(options: CloudClientOptions): CloudClient;
+/** A refusal from Dexto, from its `{ error: { code, message, requestId, retryable } }` envelope. */
+export declare class CloudApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly requestId: string | null;
+    readonly retryable: boolean;
+    readonly details: unknown;
+    constructor(input: {
+        status: number;
+        code: string;
+        message: string;
+        requestId: string | null;
+        retryable: boolean;
+        details: unknown;
+    });
+}
+/** The response's data, or a CloudApiError for Dexto's error envelope. */
+export declare function unwrap<Data>(result: {
+    data?: Data;
+    error?: unknown;
+    response: Response;
+}): Promise<Data>;
+type Method = 'get' | 'put' | 'post' | 'patch' | 'delete';
+type JsonOf<Response> = Response extends {
+    content: {
+        'application/json': infer Json;
+    };
+} ? Json : never;
+/** The JSON a /v1 operation answers with when it succeeds, such as `V1Response<'/v1/secrets', 'get'>`. */
+export type V1Response<Path extends keyof paths, M extends Method & keyof paths[Path]> = paths[Path][M] extends {
+    responses: infer Responses;
+} ? JsonOf<Responses[200 & keyof Responses]> | JsonOf<Responses[201 & keyof Responses]> : never;
+/** The JSON body a /v1 operation takes, such as `V1Body<'/v1/secrets', 'post'>`. */
+export type V1Body<Path extends keyof paths, M extends Method & keyof paths[Path]> = paths[Path][M] extends {
+    requestBody?: {
+        content: {
+            'application/json': infer Body;
+        };
+    };
+} ? Body : never;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,YAAY,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C,MAAM,WAAW,kBAAkB;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,yFAAyF;IACzF,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAC5C;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAEjE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAe1E;AAED,oGAAoG;AACpG,qBAAa,aAAc,SAAQ,KAAK;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAEd,KAAK,EAAE;QACf,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,SAAS,EAAE,OAAO,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;KACpB;CASJ;AAED,0EAA0E;AAC1E,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE;IACvC,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhB;AAuCD,KAAK,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1D,KAAK,MAAM,CAAC,QAAQ,IAAI,QAAQ,SAAS;IAAE,OAAO,EAAE;QAAE,kBAAkB,EAAE,MAAM,IAAI,CAAA;KAAE,CAAA;CAAE,GAClF,IAAI,GACJ,KAAK,CAAC;AAEZ,0GAA0G;AAC1G,MAAM,MAAM,UAAU,CAClB,IAAI,SAAS,MAAM,KAAK,EACxB,CAAC,SAAS,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IACpC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;IAAE,SAAS,EAAE,MAAM,SAAS,CAAA;CAAE,GACnD,MAAM,CAAC,SAAS,CAAC,GAAG,GAAG,MAAM,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,GAAG,MAAM,SAAS,CAAC,CAAC,GACnF,KAAK,CAAC;AAEZ,oFAAoF;AACpF,MAAM,MAAM,MAAM,CACd,IAAI,SAAS,MAAM,KAAK,EACxB,CAAC,SAAS,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IACpC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;IAAE,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE;YAAE,kBAAkB,EAAE,MAAM,IAAI,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,GACtF,IAAI,GACJ,KAAK,CAAC"}

package/dist/index.js

@@ -0,0 +1,81 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/index.ts
+import createClient from "openapi-fetch";
+var DEXTO_CLOUD_PROJECT_HEADER = "Dexto-Cloud-Project";
+function createCloudClient(options) {
+  const client = createClient({
+    baseUrl: options.apiBaseUrl.replace(/\/+$/u, ""),
+    ...options.fetch === void 0 ? {} : { fetch: options.fetch }
+  });
+  client.use({
+    async onRequest({ request }) {
+      const token = typeof options.token === "string" ? options.token : await options.token();
+      request.headers.set("authorization", `Bearer ${token}`);
+      if (options.cloudProject !== null)
+        request.headers.set(DEXTO_CLOUD_PROJECT_HEADER, options.cloudProject);
+      return request;
+    }
+  });
+  return client;
+}
+var CloudApiError = class extends Error {
+  constructor(input) {
+    super(input.message);
+    __publicField(this, "status");
+    __publicField(this, "code");
+    __publicField(this, "requestId");
+    __publicField(this, "retryable");
+    __publicField(this, "details");
+    this.name = "CloudApiError";
+    this.status = input.status;
+    this.code = input.code;
+    this.requestId = input.requestId;
+    this.retryable = input.retryable;
+    this.details = input.details;
+  }
+};
+async function unwrap(result) {
+  if (result.error === void 0) {
+    if (result.data === void 0) throw errorFor(result.response.status, null);
+    return result.data;
+  }
+  throw errorFor(result.response.status, result.error);
+}
+function errorFor(status, body) {
+  var _a, _b, _c, _d;
+  const envelope = readEnvelope(body);
+  return new CloudApiError({
+    status,
+    code: (_a = envelope == null ? void 0 : envelope.code) != null ? _a : `http_${status}`,
+    message: (_b = envelope == null ? void 0 : envelope.message) != null ? _b : `Dexto answered HTTP ${status}.`,
+    requestId: (_c = envelope == null ? void 0 : envelope.requestId) != null ? _c : null,
+    retryable: (_d = envelope == null ? void 0 : envelope.retryable) != null ? _d : status >= 500,
+    details: envelope == null ? void 0 : envelope.details
+  });
+}
+function readEnvelope(body) {
+  if (typeof body !== "object" || body === null || !("error" in body)) return null;
+  const error = body.error;
+  if (typeof error !== "object" || error === null) return null;
+  const field = (name) => name in error ? Reflect.get(error, name) : void 0;
+  const code = field("code");
+  const message = field("message");
+  if (typeof code !== "string" || typeof message !== "string") return null;
+  const requestId = field("requestId");
+  const retryable = field("retryable");
+  return {
+    code,
+    message,
+    requestId: typeof requestId === "string" ? requestId : null,
+    retryable: retryable === true,
+    details: field("details")
+  };
+}
+export {
+  CloudApiError,
+  createCloudClient,
+  unwrap
+};

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@dexto/cloud-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.15.0-beta.0",
+  "private": false,
+  "description": "Typed client for Dexto's public /v1 API, generated from its OpenAPI document",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "openapi-fetch": "^0.17.0"
+  },
+  "devDependencies": {
+    "openapi-typescript": "^7.13.0",
+    "tsup": "^8.0.2",
+    "typescript": "^5.4.2",
+    "vitest": "^4.1.12"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup && node ../../scripts/clean-tsbuildinfo.mjs && tsc -b tsconfig.json --emitDeclarationOnly",
+    "sync": "tsx scripts/sync-openapi.ts",
+    "typecheck": "tsc -p tsconfig.typecheck.json --noEmit",
+    "lint": "eslint . --ext .ts",
+    "test": "vitest run"
+  }
 }