@astermd-hq/sdk 0.0.2 → 0.0.5

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 AsterMD
+Copyright (c) 2026 CodeClouds™ DBA AsterMD
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,6 +1,10 @@
+<p align="center">
+  <a href="https://www.astermd.com/"><img src="https://raw.githubusercontent.com/astermd/node-sdk/main/.github/assets/astermd-logo.svg" alt="AsterMD" height="48"></a>
+</p>
+
 # AsterMD Node.js SDK
 
-Slim, framework-agnostic TypeScript SDK for the AsterMD order-flow API.
+Slim, framework-agnostic TypeScript SDK for the [AsterMD](https://www.astermd.com/) telehealth API: sessions, intake forms and orders. AsterMD is a white-label, API-first telehealth platform.
 
 - Node `>=22`
 - **Zero runtime dependencies** - the platform `fetch`, `node:crypto`, and `node:fs` only
@@ -78,7 +82,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`.
 
@@ -227,10 +231,10 @@ you prefer.
 
 ## Compliance
 
-This SDK is a client for an API that carries personal and protected health
-information. Using it does not by itself make your application HIPAA compliant -
-that depends on your own infrastructure, policies, and agreements. Contact
-info@astermd.com regarding a Business Associate Agreement.
+AsterMD follows HIPAA guidelines. This SDK is a client for an API that carries personal and
+protected health information, and using it does not by itself make your application HIPAA
+compliant - that depends on your own infrastructure, policies, and agreements. Contact
+hello@astermd.com regarding a Business Associate Agreement.
 
 See [`SECURITY.md`](SECURITY.md) for vulnerability reporting and
 credential-handling guidance.
@@ -246,8 +250,18 @@ credential-handling guidance.
 
 ## Support
 
-Questions, access requests, and licensing enquiries: **info@astermd.com**
+Questions, access requests, and licensing enquiries: **hello@astermd.com**
 
 ## License
 
-[MIT](LICENSE) © 2026 AsterMD
+[MIT](LICENSE) © 2026 CodeClouds™ DBA AsterMD
+
+## Trademarks
+
+The AsterMD name and logo are proprietary to AsterMD. The MIT license covers the source code in
+this repository only and does not grant rights to use the AsterMD brand.
+
+## About AsterMD
+
+AsterMD is a telehealth platform that helps healthcare brands launch and grow virtual care services. It includes intake builders, patient portals and your choice of providers and pharmacy, with no vendor lock-in.
+[astermd.com](https://www.astermd.com/) · hello@astermd.com

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;