@insurup/sdk 0.1.14 → 0.1.15

package/dist/index.cjs

@@ -45,6 +45,8 @@ __export(index_exports, {
   InsurUpTemplateClient: () => InsurUpTemplateClient,
   InsurUpVehicleClient: () => InsurUpVehicleClient,
   InsurUpWebhookClient: () => InsurUpWebhookClient,
+  SignalRLogLevel: () => import_signalr4.LogLevel,
+  SignalRTransport: () => SignalRTransport,
   VERSION: () => VERSION,
   createGraphQLErrors: () => createGraphQLErrors,
   extractError: () => extractError,
@@ -58,7 +60,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@insurup/sdk",
-  version: "0.1.14",
+  version: "0.1.15",
   description: "Type-safe TypeScript SDK for the InsurUp insurance platform with GraphQL support. Tree-shakeable, works everywhere.",
   keywords: [
     "insurup",
@@ -139,7 +141,8 @@ var package_default = {
     vitest: "^4.1.6"
   },
   dependencies: {
-    "@insurup/contracts": "workspace:*"
+    "@insurup/contracts": "workspace:*",
+    "@microsoft/signalr": "^10.0.0"
   }
 };
 
@@ -1249,6 +1252,170 @@ var GraphQLTransport = class {
   }
 };
 
+// src/client/signalr.ts
+var import_signalr = require("@microsoft/signalr");
+var HUB_METHODS = {
+  success: "ReceiveProposalProductSuccess",
+  failed: "ReceiveProposalProductFailed",
+  inProgress: "ReceiveProposalProductInProgress",
+  revised: "ReceiveProposalProductRevised",
+  purchasing: "ReceiveProposalProductPurchasing",
+  purchased: "ReceiveProposalProductPurchased",
+  purchaseFailed: "ReceiveProposalProductPurchaseFailed",
+  coverage: "ReceiveProposalProductCoverage"
+};
+var HUB_PATH = "/hubs/proposal-detail";
+var REGISTER_METHOD = "Register";
+var SignalRTransport = class {
+  hubUrl;
+  tokenProvider;
+  logLevel;
+  connection = null;
+  /** Pending or in-flight start, shared by concurrent subscribers. */
+  startPromise = null;
+  /** Active subscriptions keyed by proposalId. */
+  subscribers = /* @__PURE__ */ new Map();
+  constructor(options) {
+    this.hubUrl = new URL(HUB_PATH, ensureTrailingSlash(options.hubsBaseUrl)).toString();
+    this.tokenProvider = options.tokenProvider;
+    this.logLevel = options.logLevel ?? import_signalr.LogLevel.Warning;
+  }
+  /**
+   * Subscribe to proposal-detail events for a given proposal. Opens the
+   * underlying hub connection on first subscribe.
+   *
+   * @returns an unsubscribe function. When the last subscriber for the last
+   *   proposal unsubscribes, the underlying connection is stopped.
+   */
+  async subscribeProposalDetail(proposalId, handlers) {
+    if (!proposalId) {
+      throw new Error("subscribeProposalDetail: proposalId is required");
+    }
+    let bucket = this.subscribers.get(proposalId);
+    const isFirstForProposal = bucket === void 0;
+    if (bucket === void 0) {
+      bucket = /* @__PURE__ */ new Set();
+      this.subscribers.set(proposalId, bucket);
+    }
+    bucket.add(handlers);
+    try {
+      const connection = await this.ensureStarted();
+      if (isFirstForProposal) {
+        await connection.send(REGISTER_METHOD, { proposalId });
+      }
+    } catch (error) {
+      bucket.delete(handlers);
+      if (bucket.size === 0) {
+        this.subscribers.delete(proposalId);
+      }
+      throw error;
+    }
+    let disposed = false;
+    return () => {
+      if (disposed) {
+        return;
+      }
+      disposed = true;
+      const current = this.subscribers.get(proposalId);
+      if (!current) {
+        return;
+      }
+      current.delete(handlers);
+      if (current.size === 0) {
+        this.subscribers.delete(proposalId);
+      }
+      if (this.subscribers.size === 0) {
+        void this.stop();
+      }
+    };
+  }
+  /** Stop the underlying hub connection if open and drop all subscribers. */
+  async close() {
+    this.subscribers.clear();
+    await this.stop();
+  }
+  async ensureStarted() {
+    if (this.connection && this.connection.state === import_signalr.HubConnectionState.Connected) {
+      return this.connection;
+    }
+    if (this.startPromise) {
+      return this.startPromise;
+    }
+    const connection = this.buildConnection();
+    this.connection = connection;
+    this.startPromise = (async () => {
+      await connection.start();
+      return connection;
+    })();
+    try {
+      return await this.startPromise;
+    } catch (error) {
+      this.connection = null;
+      throw error;
+    } finally {
+      this.startPromise = null;
+    }
+  }
+  buildConnection() {
+    const tokenProvider = this.tokenProvider;
+    const connection = new import_signalr.HubConnectionBuilder().withUrl(this.hubUrl, {
+      accessTokenFactory: tokenProvider ? () => resolveToken(tokenProvider) : void 0,
+      transport: import_signalr.HttpTransportType.WebSockets,
+      skipNegotiation: true
+    }).withAutomaticReconnect().configureLogging(this.logLevel).build();
+    this.registerHandlers(connection);
+    connection.onreconnected(() => {
+      void this.reRegisterAll(connection);
+    });
+    return connection;
+  }
+  registerHandlers(connection) {
+    const dispatch = (method, pick) => {
+      connection.on(method, (event) => {
+        const bucket = this.subscribers.get(event.proposalId);
+        if (!bucket) {
+          return;
+        }
+        for (const handlers of bucket) {
+          const fn = pick(handlers);
+          fn?.(event);
+        }
+      });
+    };
+    dispatch(HUB_METHODS.success, (h) => h.onProductSuccess);
+    dispatch(HUB_METHODS.failed, (h) => h.onProductFailed);
+    dispatch(HUB_METHODS.inProgress, (h) => h.onProductInProgress);
+    dispatch(HUB_METHODS.revised, (h) => h.onProductRevised);
+    dispatch(HUB_METHODS.purchasing, (h) => h.onProductPurchasing);
+    dispatch(HUB_METHODS.purchased, (h) => h.onProductPurchased);
+    dispatch(HUB_METHODS.purchaseFailed, (h) => h.onProductPurchaseFailed);
+    dispatch(HUB_METHODS.coverage, (h) => h.onProductCoverage);
+  }
+  async reRegisterAll(connection) {
+    for (const proposalId of this.subscribers.keys()) {
+      await connection.send(REGISTER_METHOD, { proposalId });
+    }
+  }
+  async stop() {
+    const current = this.connection;
+    if (!current) {
+      return;
+    }
+    this.connection = null;
+    if (current.state === import_signalr.HubConnectionState.Disconnected || current.state === import_signalr.HubConnectionState.Disconnecting) {
+      return;
+    }
+    await current.stop();
+  }
+};
+function ensureTrailingSlash(url) {
+  return url.endsWith("/") ? url : `${url}/`;
+}
+async function resolveToken(provider) {
+  const result = await provider();
+  return result ?? "";
+}
+
 // src/core/endpoints.ts
 var endpoints_exports = {};
 __export(endpoints_exports, {
@@ -1383,6 +1550,10 @@ var customers = {
     definition: "customers/{CustomerId}",
     render: (customerId) => "customers/{CustomerId}".replace("{CustomerId}", encodeURIComponent(customerId))
   },
+  getCustomerAssets: {
+    definition: "customers/{CustomerId}/assets",
+    render: (customerId) => "customers/{CustomerId}/assets".replace("{CustomerId}", encodeURIComponent(customerId))
+  },
   getHealthInfo: {
     definition: "customers/{CustomerId}/health-info",
     render: (customerId) => "customers/{CustomerId}/health-info".replace("{CustomerId}", encodeURIComponent(customerId))
@@ -1407,6 +1578,20 @@ var customers = {
     getCustomerEmails: {
       definition: "customers/{CustomerId}/emails",
       render: (customerId) => "customers/{CustomerId}/emails".replace("{CustomerId}", encodeURIComponent(customerId))
+    },
+    getPrimaryCustomerEmail: {
+      definition: "customers/{CustomerId}/emails/primary",
+      render: (customerId) => "customers/{CustomerId}/emails/primary".replace(
+        "{CustomerId}",
+        encodeURIComponent(customerId)
+      )
+    },
+    setPrimaryCustomerEmail: {
+      definition: "customers/{CustomerId}/emails/primary",
+      render: (customerId) => "customers/{CustomerId}/emails/primary".replace(
+        "{CustomerId}",
+        encodeURIComponent(customerId)
+      )
     }
   },
   phoneNumbers: {
@@ -1431,6 +1616,20 @@ var customers = {
         "{CustomerId}",
         encodeURIComponent(customerId)
       )
+    },
+    getPrimaryCustomerPhoneNumber: {
+      definition: "customers/{CustomerId}/phone-numbers/primary",
+      render: (customerId) => "customers/{CustomerId}/phone-numbers/primary".replace(
+        "{CustomerId}",
+        encodeURIComponent(customerId)
+      )
+    },
+    setPrimaryCustomerPhoneNumber: {
+      definition: "customers/{CustomerId}/phone-numbers/primary",
+      render: (customerId) => "customers/{CustomerId}/phone-numbers/primary".replace(
+        "{CustomerId}",
+        encodeURIComponent(customerId)
+      )
     }
   },
   contactFlows: {
@@ -2389,6 +2588,111 @@ var InsurUpAgentSetupClient = class {
 // src/clients/agentUser.ts
 var import_contracts = require("@insurup/contracts");
 var import_contracts2 = require("@insurup/contracts");
+
+// src/clients/_internal/normalize-search.ts
+var TEXT_INPUT_OPS = /* @__PURE__ */ new Set([
+  "eq",
+  "neq",
+  "textSearch",
+  "wildcard",
+  "autocomplete",
+  "contains",
+  "notContains",
+  "startsWith",
+  "notStartsWith",
+  "endsWith",
+  "notEndsWith"
+]);
+var TEXT_LIST_INPUT_OPS = /* @__PURE__ */ new Set(["in", "nin"]);
+var COMBINATOR_OPS = /* @__PURE__ */ new Set(["and", "or"]);
+function normalizeSearchInput(search) {
+  if (search === null || search === void 0) return search;
+  if (typeof search !== "object") return search;
+  return normalizeNode(search);
+}
+function normalizeNode(node) {
+  if (node === null || typeof node !== "object") return node;
+  const out = {};
+  for (const [key, value] of Object.entries(node)) {
+    if (COMBINATOR_OPS.has(key) && Array.isArray(value)) {
+      out[key] = value.map(normalizeNode);
+    } else if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+      out[key] = normalizeStringOps(value);
+    } else {
+      out[key] = value;
+    }
+  }
+  return out;
+}
+function normalizeStringOps(field) {
+  const out = {};
+  for (const [op, value] of Object.entries(field)) {
+    if (TEXT_INPUT_OPS.has(op) && typeof value === "string") {
+      out[op] = { value };
+    } else if (TEXT_LIST_INPUT_OPS.has(op) && Array.isArray(value)) {
+      out[op] = { values: value };
+    } else if (COMBINATOR_OPS.has(op) && Array.isArray(value)) {
+      out[op] = value.map((item) => normalizeStringOps(item));
+    } else {
+      out[op] = value;
+    }
+  }
+  return out;
+}
+
+// src/clients/_internal/split-unified-filter.ts
+var isObject = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+var isSearchMarked = (v) => isObject(v) && v.$search === true;
+var stripMarker = ({ $search: _marker, ...rest }) => rest;
+var nonEmpty = (o) => Object.keys(o).length > 0;
+function splitUnifiedFilter(input) {
+  if (input == null) return { filter: void 0, search: void 0 };
+  const { filter, search } = splitNode(input);
+  return {
+    filter,
+    search
+  };
+}
+function splitNode(node) {
+  const filter = {};
+  const search = {};
+  for (const [key, value] of Object.entries(node)) {
+    if ((key === "and" || key === "or") && Array.isArray(value)) {
+      const filterItems = [];
+      const searchItems = [];
+      for (const item of value) {
+        if (!isObject(item)) {
+          filterItems.push(item);
+          continue;
+        }
+        const split = splitNode(item);
+        if (split.filter) filterItems.push(split.filter);
+        if (split.search) searchItems.push(split.search);
+      }
+      if (filterItems.length > 0) filter[key] = filterItems;
+      if (searchItems.length > 0) search[key] = searchItems;
+    } else if (isSearchMarked(value)) {
+      search[key] = stripMarker(value);
+    } else {
+      filter[key] = value;
+    }
+  }
+  return {
+    filter: nonEmpty(filter) ? filter : void 0,
+    search: nonEmpty(search) ? search : void 0
+  };
+}
+
+// src/clients/_internal/build-filter-search-variables.ts
+function buildFilterSearchVariables(input) {
+  const { filter, search } = splitUnifiedFilter(input);
+  const out = {};
+  if (filter !== void 0) out.filter = filter;
+  if (search !== void 0) out.search = normalizeSearchInput(search);
+  return out;
+}
+
+// src/clients/agentUser.ts
 var InsurUpAgentUserClient = class {
   constructor(http, graphql) {
     this.http = http;
@@ -2640,8 +2944,7 @@ var InsurUpAgentUserClient = class {
       after: requestOptions?.after,
       last: requestOptions?.last,
       before: requestOptions?.before,
-      search: requestOptions?.search,
-      filter: requestOptions?.filter,
+      ...buildFilterSearchVariables(requestOptions?.filter),
       order: requestOptions?.order
     };
     const result = await this.graphql.query(query, variables, options);
@@ -2763,6 +3066,31 @@ var InsurUpCustomerClient = class {
       options
     );
   }
+  /**
+   * Retrieves the primary email address for a customer.
+   *
+   * Müşterinin birincil e-posta adresini getirir.
+   */
+  async getPrimaryCustomerEmail(customerId, options) {
+    return this.http.get(
+      endpoints.customers.emails.getPrimaryCustomerEmail.render(customerId),
+      options
+    );
+  }
+  /**
+   * Sets the primary email address for a customer (upsert — adds to the customer's email
+   * collection if missing, then marks it as primary).
+   *
+   * Müşterinin birincil e-posta adresini ayarlar (mevcut değilse koleksiyona ekler ve birincil
+   * olarak işaretler).
+   */
+  async setPrimaryCustomerEmail(request, options) {
+    return this.http.putNoContent(
+      endpoints.customers.emails.setPrimaryCustomerEmail.render(request.customerId),
+      request,
+      options
+    );
+  }
   /**
    * Retrieves all phone numbers associated with a customer.
    */
@@ -2801,6 +3129,44 @@ var InsurUpCustomerClient = class {
       options
     );
   }
+  /**
+   * Retrieves the primary phone number for a customer.
+   *
+   * Müşterinin birincil telefon numarasını getirir.
+   */
+  async getPrimaryCustomerPhoneNumber(customerId, options) {
+    return this.http.get(
+      endpoints.customers.phoneNumbers.getPrimaryCustomerPhoneNumber.render(customerId),
+      options
+    );
+  }
+  /**
+   * Sets the primary phone number for a customer (upsert — adds to the customer's phone
+   * number collection if missing, then marks it as primary).
+   *
+   * Müşterinin birincil telefon numarasını ayarlar (mevcut değilse koleksiyona ekler ve
+   * birincil olarak işaretler).
+   */
+  async setPrimaryCustomerPhoneNumber(request, options) {
+    return this.http.putNoContent(
+      endpoints.customers.phoneNumbers.setPrimaryCustomerPhoneNumber.render(request.customerId),
+      request,
+      options
+    );
+  }
+  /**
+   * Retrieves all of a customer's insurable assets (vehicles and properties) in a single
+   * polymorphic list discriminated by the `$type` field.
+   *
+   * Müşterinin tüm sigortalanabilir varlıklarını (araçlar ve mülkler) `$type` alanı ile
+   * ayırt edilen tek bir polimorfik listede getirir.
+   */
+  async getCustomerAssets(customerId, options) {
+    return this.http.get(
+      endpoints.customers.getCustomerAssets.render(customerId),
+      options
+    );
+  }
   /**
    * Assigns a specific agent representative to manage a customer's account.
    */
@@ -3100,18 +3466,15 @@ var InsurUpCustomerClient = class {
         }
       }
     `;
-    const variables = {};
-    if (requestOptions?.first === void 0 && requestOptions?.last === void 0) {
-      variables.first = 50;
-    } else {
-      if (requestOptions?.first !== void 0) variables.first = requestOptions.first;
-      if (requestOptions?.last !== void 0) variables.last = requestOptions.last;
-    }
-    if (requestOptions?.after !== void 0) variables.after = requestOptions.after;
-    if (requestOptions?.before !== void 0) variables.before = requestOptions.before;
-    if (requestOptions?.search !== void 0) variables.search = requestOptions.search;
-    if (requestOptions?.filter !== void 0) variables.filter = requestOptions.filter;
-    if (requestOptions?.order !== void 0) variables.order = requestOptions.order;
+    const first = requestOptions?.first === void 0 && requestOptions?.last === void 0 ? 50 : requestOptions?.first;
+    const variables = {
+      first,
+      after: requestOptions?.after,
+      last: requestOptions?.last,
+      before: requestOptions?.before,
+      ...buildFilterSearchVariables(requestOptions?.filter),
+      order: requestOptions?.order
+    };
     const result = await this.graphql.query(query, variables, options);
     if (!result.isSuccess) {
       return result;
@@ -3796,8 +4159,7 @@ var InsurUpPolicyClient = class {
       after: requestOptions?.after,
       last: requestOptions?.last,
       before: requestOptions?.before,
-      search: requestOptions?.search,
-      filter: requestOptions?.filter,
+      ...buildFilterSearchVariables(requestOptions?.filter),
       order: requestOptions?.order
     };
     const result = await this.graphql.query(query, variables, options);
@@ -3877,8 +4239,7 @@ var InsurUpPolicyClient = class {
       after: requestOptions?.after,
       last: requestOptions?.last,
       before: requestOptions?.before,
-      search: requestOptions?.search,
-      filter: requestOptions?.filter,
+      ...buildFilterSearchVariables(requestOptions?.filter),
       order: requestOptions?.order
     };
     const result = await this.graphql.query(query, variables, options);
@@ -3958,8 +4319,7 @@ var InsurUpPolicyClient = class {
       after: requestOptions?.after,
       last: requestOptions?.last,
       before: requestOptions?.before,
-      search: requestOptions?.search,
-      filter: requestOptions?.filter,
+      ...buildFilterSearchVariables(requestOptions?.filter),
       order: requestOptions?.order
     };
     const result = await this.graphql.query(query, variables, options);
@@ -4303,8 +4663,7 @@ var InsurUpCaseClient = class {
       after: requestOptions?.after,
       last: requestOptions?.last,
       before: requestOptions?.before,
-      search: requestOptions?.search,
-      filter: requestOptions?.filter,
+      ...buildFilterSearchVariables(requestOptions?.filter),
       order: requestOptions?.order
     };
     const result = await this.graphql.query(query, variables, options);
@@ -4488,8 +4847,7 @@ var InsurUpWebhookClient = class {
       after: requestOptions?.after,
       last: requestOptions?.last,
       before: requestOptions?.before,
-      search: requestOptions?.search,
-      filter: requestOptions?.filter,
+      ...buildFilterSearchVariables(requestOptions?.filter),
       order: requestOptions?.order
     };
     const result = await this.graphql.query(query, variables, options);
@@ -4732,9 +5090,42 @@ var InsurUpInsuranceClient = class {
 var import_contracts13 = require("@insurup/contracts");
 var import_contracts14 = require("@insurup/contracts");
 var InsurUpProposalClient = class {
-  constructor(http, graphql) {
+  constructor(http, graphql, signalR) {
     this.http = http;
     this.graphql = graphql;
+    this.signalR = signalR;
+  }
+  /**
+   * Subscribe to real-time updates for a proposal via the InsurUp SignalR
+   * ProposalDetailHub. The first subscriber opens the underlying hub
+   * connection lazily; subscriptions for additional proposals are multiplexed
+   * over the same connection. Pass only the handlers you care about.
+   *
+   * Teklif için gerçek zamanlı güncellemelere SignalR üzerinden abone olur.
+   *
+   * @param proposalId - The proposal to subscribe to / Abone olunacak teklif
+   * @param handlers - Per-event callbacks; missing entries are ignored
+   * @returns An unsubscribe function. When the last subscription is torn
+   *   down, the underlying hub connection is stopped.
+   * @throws If the SDK client was constructed without SignalR support
+   *
+   * @example
+   * ```typescript
+   * const unsub = await client.proposals.subscribeToDetail(proposalId, {
+   *   onProductSuccess: (event) => console.log('priced', event),
+   *   onProductFailed:  (event) => console.warn('failed', event.errorMessage),
+   * });
+   * // later
+   * unsub();
+   * ```
+   */
+  async subscribeToDetail(proposalId, handlers) {
+    if (!this.signalR) {
+      throw new Error(
+        "subscribeToDetail requires SignalR support; construct the client via DefaultInsurUpClient"
+      );
+    }
+    return this.signalR.subscribeProposalDetail(proposalId, handlers);
   }
   /**
    * Creates a new insurance proposal with customer information, coverage selections, and product options for quotation.
@@ -5119,8 +5510,7 @@ var InsurUpProposalClient = class {
       after: requestOptions?.after,
       last: requestOptions?.last,
       before: requestOptions?.before,
-      search: requestOptions?.search,
-      filter: requestOptions?.filter,
+      ...buildFilterSearchVariables(requestOptions?.filter),
       order: requestOptions?.order
     };
     const result = await this.graphql.query(query, variables, options);
@@ -5265,6 +5655,7 @@ var InsurUpTemplateClient = class {
 var DefaultInsurUpClient = class {
   http;
   graphql;
+  signalR;
   /**
    * Agent Management Client
    *
@@ -5389,6 +5780,11 @@ var DefaultInsurUpClient = class {
     this.http = new HttpTransport(options);
     this.graphql = new GraphQLTransport(this.http);
     this.options = options || {};
+    this.signalR = new SignalRTransport({
+      hubsBaseUrl: options?.hubsBaseUrl ?? deriveHubsBaseUrl(options?.baseUrl),
+      tokenProvider: options?.tokenProvider,
+      logLevel: options?.signalRLogLevel
+    });
     this.agents = new InsurUpAgentClient(this.http);
     this.agentBranches = new InsurUpAgentBranchClient(this.http);
     this.agentRoles = new InsurUpAgentRoleClient(this.http);
@@ -5402,14 +5798,27 @@ var DefaultInsurUpClient = class {
     this.webhooks = new InsurUpWebhookClient(this.http, this.graphql);
     this.coverage = new InsurUpCoverageClient(this.http);
     this.insurance = new InsurUpInsuranceClient(this.http);
-    this.proposals = new InsurUpProposalClient(this.http, this.graphql);
+    this.proposals = new InsurUpProposalClient(this.http, this.graphql, this.signalR);
     this.files = new InsurUpFileClient(this.http);
     this.languages = new InsurUpLanguageClient(this.http);
     this.templates = new InsurUpTemplateClient(this.http);
   }
+  /**
+   * Stop any open SignalR connection and drop pending subscribers. Safe to
+   * call multiple times. Call this when disposing of the SDK client (e.g. on
+   * app teardown or test cleanup).
+   */
+  async close() {
+    await this.signalR.close();
+  }
 };
+function deriveHubsBaseUrl(baseUrl) {
+  const resolved = baseUrl ?? "https://api.insurup.com/api/";
+  return new URL(resolved).origin;
+}
 
 // src/index.ts
+var import_signalr4 = require("@microsoft/signalr");
 __reExport(index_exports, require("@insurup/contracts"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -5437,6 +5846,8 @@ __reExport(index_exports, require("@insurup/contracts"), module.exports);
   InsurUpTemplateClient,
   InsurUpVehicleClient,
   InsurUpWebhookClient,
+  SignalRLogLevel,
+  SignalRTransport,
   VERSION,
   createGraphQLErrors,
   extractError,