@delegance/sdk 0.2.0 → 0.3.0

package/dist/index.js

@@ -55,6 +55,7 @@ __export(index_exports, {
   SDK_VERSION: () => SDK_VERSION,
   SOVModule: () => SOVModule,
   SignupModule: () => SignupModule,
+  TermsModule: () => TermsModule,
   UsageModule: () => UsageModule,
   ValidationError: () => ValidationError,
   createClientFromEnv: () => createClientFromEnv,
@@ -157,7 +158,7 @@ var NotImplementedError = class extends DeleganceError {
 };
 
 // src/utils/http.ts
-var SDK_VERSION = "0.2.0";
+var SDK_VERSION = "0.3.0";
 var DEFAULT_BASE_URL = "https://portal.delegancebrokerage.com";
 function isRetryableStatus(status) {
   return status >= 500 && status !== 501;
@@ -253,6 +254,7 @@ var HttpClient = class {
         if (!response.ok) {
           const err = this.handleErrorResponse(response.status, data, traceId);
           if (typeof data.reason === "string") err.reason = data.reason;
+          if (typeof data.code === "string") err.code = data.code;
           if (data && typeof data === "object") err.body = data;
           if (err instanceof RateLimitError && err.retryAfter === void 0) {
             const header = Number(response.headers?.get?.("Retry-After"));
@@ -319,7 +321,11 @@ var CompaniesModule = class {
     this.http = http;
   }
   /**
-   * Create a new company
+   * Create a new company.
+   *
+   * @deprecated A customer API key cannot create companies (403
+   * `tenant_key_cannot_create`). To open a new account, use
+   * `createSignup().createAccount()`.
    * 
    * @example
    * ```typescript
@@ -348,14 +354,11 @@ var CompaniesModule = class {
     return response.company;
   }
   /**
-   * List companies accessible to this API key
-   * 
+   * List the company this API key belongs to. A key belongs to one company.
+   *
    * @example
    * ```typescript
-   * const companies = await client.companies.list();
-   * 
-   * // Include companies created via this API key
-   * const allCompanies = await client.companies.list({ includeCreated: true });
+   * const [company] = await client.companies.list();
    * ```
    */
   async list(options = {}) {
@@ -372,7 +375,10 @@ var CompaniesModule = class {
     return response.companies;
   }
   /**
-   * Get a company by ID
+   * Get a company by ID.
+   *
+   * @deprecated The server has no `GET /api/v1/companies/{id}` route, so this
+   * returns 404. Use `list()`, which returns the key's own company.
    * 
    * @example
    * ```typescript
@@ -387,7 +393,10 @@ var CompaniesModule = class {
     return response.company;
   }
   /**
-   * Create a company if it doesn't exist (using externalId for deduplication)
+   * Create a company if it doesn't exist (using externalId for deduplication).
+   *
+   * @deprecated A customer API key cannot create companies. Use
+   * `createSignup().createAccount()` for a new account.
    * 
    * @example
    * ```typescript
@@ -433,7 +442,6 @@ var DocumentsModule = class {
    * import fs from 'fs';
    * 
    * const doc = await client.documents.upload({
-   *   companyId: 'company-uuid',
    *   file: fs.readFileSync('./policy.pdf'),
    *   fileName: 'GL-2025.pdf',
    *   documentType: 'policy'
@@ -443,9 +451,6 @@ var DocumentsModule = class {
    * ```
    */
   async upload(input) {
-    if (!input.companyId) {
-      throw new ValidationError("companyId is required");
-    }
     if (!input.file) {
       throw new ValidationError("file is required");
     }
@@ -458,9 +463,10 @@ var DocumentsModule = class {
     } else {
       fileData = input.file;
     }
-    const additionalFields = {
-      companyId: input.companyId
-    };
+    const additionalFields = {};
+    if (input.companyId) {
+      additionalFields.companyId = input.companyId;
+    }
     if (input.documentType) {
       additionalFields.documentType = input.documentType;
     }
@@ -484,8 +490,8 @@ var DocumentsModule = class {
    * @example
    * ```typescript
    * const docs = await client.documents.uploadBatch([
-   *   { companyId, file: buffer1, fileName: 'policy1.pdf' },
-   *   { companyId, file: buffer2, fileName: 'policy2.pdf' }
+   *   { file: buffer1, fileName: 'policy1.pdf' },
+   *   { file: buffer2, fileName: 'policy2.pdf' }
    * ]);
    * ```
    */
@@ -1159,7 +1165,7 @@ var SOVModule = class {
 };
 
 // src/modules/api-keys.ts
-var API_KEY_SCOPES = ["read", "write", "admin", "appetite:read", "mcp:read", "mcp:orin"];
+var API_KEY_SCOPES = ["read", "write", "admin", "appetite:read", "mcp:read", "mcp:orin", "claims:write"];
 var ApiKeysModule = class {
   constructor(http) {
     this.http = http;
@@ -1845,6 +1851,27 @@ var FeedbackModule = class {
   }
 };
 
+// src/modules/terms.ts
+var TermsModule = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** The current version, the Terms / Privacy / SLA links, and the summaries to show. */
+  async get() {
+    const res = await this.http.request({ method: "GET", path: "/api/v1/legal/terms" });
+    return res.data;
+  }
+  /** Accept `version` (it must be the current one; read it with `get`). */
+  async accept(version) {
+    const res = await this.http.request({
+      method: "POST",
+      path: "/api/v1/legal/terms/accept",
+      body: { termsAccepted: true, termsVersion: version }
+    });
+    return res.data;
+  }
+};
+
 // src/modules/signup.ts
 var import_crypto7 = require("crypto");
 
@@ -1896,6 +1923,15 @@ var SignupModule = class {
       ...res.warnings?.length ? { warnings: res.warnings } : {}
     };
   }
+  /** The current Terms of Service version and links. Public: no key. */
+  async getTerms() {
+    const res = await this.makeHttp("").request({ method: "GET", path: "/api/v1/legal/terms" });
+    return res.data;
+  }
+  /**
+   * Register this terminal. The server refuses without `termsAccepted: true`
+   * and the CURRENT `termsVersion` (from `getTerms`).
+   */
   async enroll(bootstrapKey, input) {
     const res = await this.makeHttp(bootstrapKey).request({
       method: "POST",
@@ -2026,6 +2062,7 @@ var DeleganceClient = class {
     this.claims = new ClaimsModule(this.http);
     this.feedback = new FeedbackModule(this.http);
     this.auth = new AuthModule(this.http);
+    this.terms = new TermsModule(this.http);
   }
   /**
    * Get the SDK version
@@ -2109,6 +2146,7 @@ function createDeviceLogin(config = {}) {
   SDK_VERSION,
   SOVModule,
   SignupModule,
+  TermsModule,
   UsageModule,
   ValidationError,
   createClientFromEnv,

package/dist/index.mjs

@@ -91,7 +91,7 @@ var NotImplementedError = class extends DeleganceError {
 };
 
 // src/utils/http.ts
-var SDK_VERSION = "0.2.0";
+var SDK_VERSION = "0.3.0";
 var DEFAULT_BASE_URL = "https://portal.delegancebrokerage.com";
 function isRetryableStatus(status) {
   return status >= 500 && status !== 501;
@@ -187,6 +187,7 @@ var HttpClient = class {
         if (!response.ok) {
           const err = this.handleErrorResponse(response.status, data, traceId);
           if (typeof data.reason === "string") err.reason = data.reason;
+          if (typeof data.code === "string") err.code = data.code;
           if (data && typeof data === "object") err.body = data;
           if (err instanceof RateLimitError && err.retryAfter === void 0) {
             const header = Number(response.headers?.get?.("Retry-After"));
@@ -253,7 +254,11 @@ var CompaniesModule = class {
     this.http = http;
   }
   /**
-   * Create a new company
+   * Create a new company.
+   *
+   * @deprecated A customer API key cannot create companies (403
+   * `tenant_key_cannot_create`). To open a new account, use
+   * `createSignup().createAccount()`.
    * 
    * @example
    * ```typescript
@@ -282,14 +287,11 @@ var CompaniesModule = class {
     return response.company;
   }
   /**
-   * List companies accessible to this API key
-   * 
+   * List the company this API key belongs to. A key belongs to one company.
+   *
    * @example
    * ```typescript
-   * const companies = await client.companies.list();
-   * 
-   * // Include companies created via this API key
-   * const allCompanies = await client.companies.list({ includeCreated: true });
+   * const [company] = await client.companies.list();
    * ```
    */
   async list(options = {}) {
@@ -306,7 +308,10 @@ var CompaniesModule = class {
     return response.companies;
   }
   /**
-   * Get a company by ID
+   * Get a company by ID.
+   *
+   * @deprecated The server has no `GET /api/v1/companies/{id}` route, so this
+   * returns 404. Use `list()`, which returns the key's own company.
    * 
    * @example
    * ```typescript
@@ -321,7 +326,10 @@ var CompaniesModule = class {
     return response.company;
   }
   /**
-   * Create a company if it doesn't exist (using externalId for deduplication)
+   * Create a company if it doesn't exist (using externalId for deduplication).
+   *
+   * @deprecated A customer API key cannot create companies. Use
+   * `createSignup().createAccount()` for a new account.
    * 
    * @example
    * ```typescript
@@ -367,7 +375,6 @@ var DocumentsModule = class {
    * import fs from 'fs';
    * 
    * const doc = await client.documents.upload({
-   *   companyId: 'company-uuid',
    *   file: fs.readFileSync('./policy.pdf'),
    *   fileName: 'GL-2025.pdf',
    *   documentType: 'policy'
@@ -377,9 +384,6 @@ var DocumentsModule = class {
    * ```
    */
   async upload(input) {
-    if (!input.companyId) {
-      throw new ValidationError("companyId is required");
-    }
     if (!input.file) {
       throw new ValidationError("file is required");
     }
@@ -392,9 +396,10 @@ var DocumentsModule = class {
     } else {
       fileData = input.file;
     }
-    const additionalFields = {
-      companyId: input.companyId
-    };
+    const additionalFields = {};
+    if (input.companyId) {
+      additionalFields.companyId = input.companyId;
+    }
     if (input.documentType) {
       additionalFields.documentType = input.documentType;
     }
@@ -418,8 +423,8 @@ var DocumentsModule = class {
    * @example
    * ```typescript
    * const docs = await client.documents.uploadBatch([
-   *   { companyId, file: buffer1, fileName: 'policy1.pdf' },
-   *   { companyId, file: buffer2, fileName: 'policy2.pdf' }
+   *   { file: buffer1, fileName: 'policy1.pdf' },
+   *   { file: buffer2, fileName: 'policy2.pdf' }
    * ]);
    * ```
    */
@@ -1093,7 +1098,7 @@ var SOVModule = class {
 };
 
 // src/modules/api-keys.ts
-var API_KEY_SCOPES = ["read", "write", "admin", "appetite:read", "mcp:read", "mcp:orin"];
+var API_KEY_SCOPES = ["read", "write", "admin", "appetite:read", "mcp:read", "mcp:orin", "claims:write"];
 var ApiKeysModule = class {
   constructor(http) {
     this.http = http;
@@ -1779,6 +1784,27 @@ var FeedbackModule = class {
   }
 };
 
+// src/modules/terms.ts
+var TermsModule = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** The current version, the Terms / Privacy / SLA links, and the summaries to show. */
+  async get() {
+    const res = await this.http.request({ method: "GET", path: "/api/v1/legal/terms" });
+    return res.data;
+  }
+  /** Accept `version` (it must be the current one; read it with `get`). */
+  async accept(version) {
+    const res = await this.http.request({
+      method: "POST",
+      path: "/api/v1/legal/terms/accept",
+      body: { termsAccepted: true, termsVersion: version }
+    });
+    return res.data;
+  }
+};
+
 // src/modules/signup.ts
 import { createHash, randomBytes, randomUUID as randomUUID7 } from "crypto";
 
@@ -1830,6 +1856,15 @@ var SignupModule = class {
       ...res.warnings?.length ? { warnings: res.warnings } : {}
     };
   }
+  /** The current Terms of Service version and links. Public: no key. */
+  async getTerms() {
+    const res = await this.makeHttp("").request({ method: "GET", path: "/api/v1/legal/terms" });
+    return res.data;
+  }
+  /**
+   * Register this terminal. The server refuses without `termsAccepted: true`
+   * and the CURRENT `termsVersion` (from `getTerms`).
+   */
   async enroll(bootstrapKey, input) {
     const res = await this.makeHttp(bootstrapKey).request({
       method: "POST",
@@ -1960,6 +1995,7 @@ var DeleganceClient = class {
     this.claims = new ClaimsModule(this.http);
     this.feedback = new FeedbackModule(this.http);
     this.auth = new AuthModule(this.http);
+    this.terms = new TermsModule(this.http);
   }
   /**
    * Get the SDK version
@@ -2042,6 +2078,7 @@ export {
   SDK_VERSION,
   SOVModule,
   SignupModule,
+  TermsModule,
   UsageModule,
   ValidationError,
   createClientFromEnv,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@delegance/sdk",
-  "version": "0.2.0",
-  "description": "TypeScript SDK for integrating with Delegance Brokerage platform",
+  "version": "0.3.0",
+  "description": "Get commercial insurance quotes from your code: TypeScript SDK for the Delegance API (instant quotes, signup, policies, certificates)",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -36,11 +36,13 @@
     "insurance-quote",
     "brokerage",
     "sdk",
-    "api"
+    "api",
+    "ai-agent",
+    "mcp"
   ],
   "author": "Delegance Inc.",
   "license": "MIT",
-  "homepage": "https://delegancebrokerage.com",
+  "homepage": "https://portal.delegancebrokerage.com/docs/sdk",
   "bugs": {
     "email": "support@delegancebrokerage.com"
   },
@@ -66,5 +68,8 @@
     "typescript": {
       "optional": true
     }
+  },
+  "overrides": {
+    "esbuild": "^0.28.1"
   }
 }