Addressly — Custom integration guide

window._addressly.core = new Addressly(); window._addressly.core.init();  window._addressly.mainWidget = new AddresslyWidget(); window._addressly.mainWidget.init();

document.addEventListener("addressly:core-ready", (event) => {   
    const { location, assignedStore, assignedZone } = event.detail;
    // Safe to read core + storage-backed state
});

const core = window._addressly.core;

// Programmatically set location (must include address + coordinates)
await core.processLocationData({
  coordinates: {
    latitude: 40.7128,
    longitude: -74.006,
    map_location: core.getGoogleMapsUrl(40.7128, -74.006),
  },
  address: {
    address1: "123 Main St",
    city: "New York",
    province: "NY",
    province_code: "NY",
    zip: "10001",
    country: "United States",
    country_code: "US",
  },
  customer_verified: true, // required if location_verification_required is enabled
  address_id: null,       // optional, for saved customer addresses
  address_label: null,
  address_type: null,
});

// Read current state without parsing storage
const location = core.CURRENT_LOCATION;
const store = core.getAssignedStore(); // may differ from ASSIGNED_STORE (zone vs nearest logic)
const inZone = core.isLocationInDeliveryZone();
const confirmed = core.isLocationConfirmed(null, true); // strict = requires coords + address
const checkout = core.shouldDisableCheckout(); // { shouldDisable, reasons[] }

// Browser or Apploy device location (user gesture recommended)
const live = await core.getCurrentLocation();

// Reverse geocode coordinates → address object
const address = await core.reverseGeocode({ latitude, lng, map_location });

// Nearest store / zone for arbitrary coordinates
const store = core.getStoreForLocation({ coordinates, address });
const zone = core.getZoneForLocation({ coordinates, address });

// Temporary place (modal flow)
core.updateTemporaryPlaceData({ coordinates, address });
core.updateTemporaryPlaceAddress({ address1: "..." });
core.getTemporaryPlaceData();
core.clearTemporaryPlaceData();

// Custom events (same bus as built-in events)
core.dispatchEvent("my-app:custom", { foo: "bar" });

const widget = window._addressly.mainWidget;

// Modal types: "location" | "store-hours" | "out-of-delivery-zone" | "far-from-location"
widget.openAddresslyModal("location", 1);  // step 1 = search / use my location
widget.openAddresslyModal("location", 2);  // step 2 = map confirm
widget.openAddresslyModal("store-hours");
widget.openAddresslyModal("out-of-delivery-zone");
widget.openAddresslyModal("far-from-location");

widget.closeAddresslyModal();              // closes backdrop + resets location modal temp state
widget.resetAndCloseAddresslyModal();      // reset temp place + close

widget.isAddresslyModalOpen();             // backdrop has class "open"
widget.goBack();                           // location modal: previous step or close on step 1

window._addressly.mainWidget.handleModalState({
  action: "show_location_verification_modal",
});

document.addEventListener("addressly:location-updated", (event) => {
  const { location, assignedStore, assignedZone } = event.detail;

  console.log("Deliver to:", location.address.address1);
  console.log("Store:", assignedStore?.name);
  console.log("Zone:", assignedZone?.name);

  // Update your custom UI
  document.querySelector("#my-delivery-label").textContent =
    location.address.address1;
});

document.addEventListener("addressly:location-resolved", (event) => {
  if (!event.detail.provisional) return;
  const temp = event.detail.placeData;
  // User is still on confirm step — do not treat as final delivery address
});

document.addEventListener("addressly:location-updated", (event) => {
  // Confirmed — safe for checkout / fulfillment logic
});

function readAddresslyLocation() {
  try {
    const raw = localStorage.getItem("addressly-location");
    return raw ? JSON.parse(raw) : null;
  } catch {
    return null;
  }
}

// Or from core (respects guest vs logged-in address_id stripping)
const location = window._addressly?.core?.getLocationFromLocalStorage()
  ?? window._addressly?.core?.CURRENT_LOCATION;

{
  "coordinates": {
    "latitude": 40.7128,
    "longitude": -74.006,
    "map_location": "https://www.google.com/maps?q=40.7128,-74.006"
  },
  "address": {
    "address1": "123 Main St",
    "address2": "",
    "city": "New York",
    "province": "NY",
    "province_code": "NY",
    "zip": "10001",
    "country": "United States",
    "country_code": "US",
    "first_name": null,
    "last_name": null,
    "phone": null
  },
  "customer_verified": true,
  "address_id": "gid://shopify/CustomerAddress/...",
  "address_label": "Home",
  "address_type": "home",
  "strategy": "browser_location"
}

const store = JSON.parse(
  localStorage.getItem("addressly-assigned-store") || "null"
);
const zone = JSON.parse(
  localStorage.getItem("addressly-assigned-zone") || "null"
);

// Prefer live core state after init (handles out-of-zone nulling)
const liveStore = window._addressly?.core?.ASSIGNED_STORE;
const liveZone = window._addressly?.core?.ASSIGNED_ZONE;

const attrs = window._addressly.core.getCartAttributes(); 
const props = window._addressly.core.getLineItemProperties();

<button type="button" id="my-change-address">Change address</button>

document.getElementById("my-change-address")?.addEventListener("click", () => {
  window._addressly?.mainWidget?.openAddresslyModal("location", 1);
});

function renderDeliverySummary() {
  const loc = window._addressly?.core?.CURRENT_LOCATION;
  const store = window._addressly?.core?.ASSIGNED_STORE;
  if (!loc) return "Add delivery address";
  return `${loc.address.address1} · ${store?.name ?? "No store"}`;
}

document.addEventListener("addressly:location-updated", renderDeliverySummary);
document.addEventListener("addressly:core-ready", renderDeliverySummary);

const core = window._addressly.core;
const position = await core.getCurrentLocation();
if (position) {
  await core.processLocationData({ ...position, customer_verified: true });
}

function syncCheckoutCta() {
  const { shouldDisable, reasons } =
    window._addressly.core.shouldDisableCheckout();
  document.querySelector("#my-checkout").disabled = shouldDisable;
  document.querySelector("#my-checkout-hint").hidden = !reasons.includes(
    "out_of_delivery_zone"
  );
}

document.addEventListener("addressly:location-updated", syncCheckoutCta);
document.addEventListener("addressly:core-ready", syncCheckoutCta);

document.addEventListener("addressly:location-updated", () => {
  const core = window._addressly.core;
  if (!core.isLocationInDeliveryZone()) {
    // Show your own banner — avoid calling showOutOfZoneModal()
    showCustomOutOfZoneBanner(window._addressly.coreSettings.out_of_zone_message);
  }
});