@astermd-hq/sdk 0.0.2 → 0.0.4

package/README.md

@@ -78,7 +78,7 @@ per request throws that cache away.
 ## Resources
 
 `sessions`, `intakeSubmissions`, `carts`, `checkoutEvents`, `teleforms`,
-`patients`, `opportunities`, `treatments`, `doctorsNetworks`, `channels`,
+`patients`, `opportunities`, `treatments`, `coupons`, `doctorsNetworks`, `channels`,
 `products`, `categories`, `labTests`, `medications`, `shippings`,
 `verification`, `geo`.
 

package/dist/index.cjs

@@ -1341,7 +1341,13 @@ var CheckoutEvents = class extends AbstractResource {
    * Send one call per state the visitor reaches: an upsell offered, then accepted
    * or declined, then the order placed or declined. The payload carries whatever
    * context that state needs, but it can never override `event` - the state
-   * recorded is always the one you passed explicitly.
+   * recorded is always the one you passed explicitly. For an `OrderPlaced` event,
+   * `data` may include an optional `payment` object describing the settled
+   * payment method: `type` (`paypal` | `apple_pay` | `gpay` | `credit_card` |
+   * `pre_paid`), `pre_auth` (boolean), `pre_auth_qa` and `pre_auth_amount`
+   * (optional), and an optional `card` object (`type` - `amex` | `visa` |
+   * `mastercard` | `discover` | `diners_club` | `jcb`, optional `bin`, required
+   * `exp`).
    *
    * @param options The session, the new state, and any context for it.
    * @returns The updated checkout-event record.
@@ -1361,6 +1367,60 @@ var CheckoutEvents = class extends AbstractResource {
   }
 };
 
+// src/resource/coupons.ts
+var Coupons = class extends AbstractResource {
+  /**
+   * @param transport The shared transport.
+   */
+  constructor(transport) {
+    super(transport);
+  }
+  /**
+   * Checks a coupon code against a cart without redeeming it.
+   *
+   * Call this when the shopper applies a code at checkout, before the payment is
+   * created. The server validates the coupon's status, validity window, patient,
+   * products, budget, scope and redemption limits, and prices the cart. The check
+   * has no side effects. Inspect `data()` on the response for the coupon terms,
+   * the price before and after the discount, and the discounted lines. A shopper
+   * who is not a patient yet only fits a coupon open to anyone.
+   *
+   * @param options The code, the cart, and optionally who the shopper is
+   *   (`patientId`, `email` or `opportunityId`). Each optional identifier is sent
+   *   only when provided.
+   * @returns The coupon check; `data()` holds `coupon_id`, `name`,
+   *   `discount_type`, `value`, `tiers`, `default_scope`, `gross_amount_cents`,
+   *   `discount_cents`, `amount_cents`, `currency` and the discounted `items`.
+   * @throws {NotFoundError} If no coupon exists with this code.
+   * @throws {ValidationError} If the coupon cannot be used on this cart, or the
+   *   cart cannot be priced.
+   * @throws {AuthenticationError} If the credentials are refused.
+   * @throws {ApiError} On any other non-2xx status.
+   * @throws {TransportError} If the request never completed.
+   */
+  async validate(options) {
+    const body = {
+      code: options.code,
+      items: options.items
+    };
+    if (options.patientId !== void 0) {
+      body.patient_id = options.patientId;
+    }
+    if (options.email !== void 0) {
+      body.email = options.email;
+    }
+    if (options.opportunityId !== void 0) {
+      body.opportunity_id = options.opportunityId;
+    }
+    return await this.transport.send({
+      service: "sales",
+      method: "POST",
+      path: "/coupons/validate",
+      body
+    });
+  }
+};
+
 // src/resource/doctors-networks.ts
 var DoctorsNetworks = class extends AbstractResource {
   /**
@@ -2415,7 +2475,8 @@ var Sessions = class extends AbstractResource {
    *
    * @param session The session identifier to update.
    * @param data Fields to record. Forwarded unmodified; see the API reference in
-   *   your AsterMD dashboard for the recognised keys.
+   *   your AsterMD dashboard for the recognised keys. Accepts the same optional
+   *   `verification` object documented on {@link Sessions.create}.
    * @returns The updated session.
    * @throws {NotFoundError} If the session does not exist.
    * @throws {ValidationError} If the payload is rejected.
@@ -2630,16 +2691,24 @@ var Treatments = class extends AbstractResource {
    * The alternative to {@link Treatments.create} for flows where checkout happens
    * outside your storefront: hand over the session and your order identifiers and
    * the server creates the treatments and attributes them to that session's
-   * journey. Several orders can be reconciled in one call.
+   * journey. Several orders can be reconciled in one call. `payment`, when
+   * supplied, carries the settled payment method for the order; `verification`,
+   * when supplied, records identity/contact verification already performed by
+   * the caller.
    *
-   * @param options The session, your order identifiers, and optional attribution.
+   * @param options The session, your order identifiers, the required user agent,
+   *   and optional attribution, payment, and verification details.
    * @returns The created treatments.
+   * @throws {TypeError} If `userAgent` is missing or empty.
    * @throws {ValidationError} If the session or an order identifier is rejected.
    * @throws {NotFoundError} If the session does not exist.
    * @throws {ApiError} On any other non-2xx status.
    * @throws {TransportError} If the request never completed.
    */
   async sync(options) {
+    if (options.userAgent === void 0 || options.userAgent === "") {
+      throw new TypeError("Treatments.sync requires a non-empty userAgent.");
+    }
     const body = {
       session_id: options.session,
       order_ids: options.orderIds
@@ -2647,13 +2716,35 @@ var Treatments = class extends AbstractResource {
     if (options.utmSource !== void 0) {
       body.utm_source = options.utmSource;
     }
-    const headers = options.userAgent !== void 0 && options.userAgent !== "" ? { "User-Agent": options.userAgent } : {};
+    if (options.payment !== void 0) {
+      const payment = {
+        type: options.payment.type,
+        pre_auth: options.payment.preAuth
+      };
+      if (options.payment.preAuthQa !== void 0) {
+        payment.pre_auth_qa = options.payment.preAuthQa;
+      }
+      if (options.payment.preAuthAmount !== void 0) {
+        payment.pre_auth_amount = options.payment.preAuthAmount;
+      }
+      if (options.payment.card !== void 0) {
+        payment.card = options.payment.card;
+      }
+      body.payment = payment;
+    }
+    if (options.verification !== void 0) {
+      body.verification = {
+        email: options.verification.email,
+        address: options.verification.address,
+        ...options.verification.id !== void 0 ? { id: options.verification.id } : {}
+      };
+    }
     return await this.transport.send({
       service: "sales",
       method: "POST",
       path: "/treatments/sync",
       body,
-      headers
+      headers: { "User-Agent": options.userAgent }
     });
   }
 };
@@ -2773,6 +2864,7 @@ var AsterMDClient = class {
   #patients;
   #opportunities;
   #treatments;
+  #coupons;
   #doctorsNetworks;
   #channels;
   #products;
@@ -2886,6 +2978,10 @@ var AsterMDClient = class {
   treatments() {
     return this.#treatments ??= new Treatments(this.#transport);
   }
+  /** Coupons - checking a code the shopper typed against their cart. */
+  coupons() {
+    return this.#coupons ??= new Coupons(this.#transport);
+  }
   /** Doctors' networks - handing a case to the clinicians who review it. */
   doctorsNetworks() {
     return this.#doctorsNetworks ??= new DoctorsNetworks(this.#transport);
@@ -3307,6 +3403,7 @@ exports.Channels = Channels;
 exports.CheckoutEvent = CheckoutEvent;
 exports.CheckoutEvents = CheckoutEvents;
 exports.Config = Config;
+exports.Coupons = Coupons;
 exports.DailyFileLogSink = DailyFileLogSink;
 exports.DoctorsNetworks = DoctorsNetworks;
 exports.Event = Event;