npm - @momentco-ai/moment-sdk - Versions diffs - 0.1.0-dev.1 - Mend

@momentco-ai/moment-sdk 0.1.0-dev.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/LICENSE +21 -0
package/README.md +188 -0
package/dist/moment-sdk.js +1 -0
package/dist/moment-sdk.mjs +342 -0
package/dist/types/sdk/button.d.ts +15 -0
package/dist/types/sdk/index.d.ts +4 -0
package/dist/types/sdk/moment-sdk.d.ts +50 -0
package/dist/types/sdk/popup-bridge.d.ts +36 -0
package/dist/types/sdk/types.d.ts +58 -0
package/package.json +70 -0

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 Moment Co.
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md ADDED Viewed

@@ -0,0 +1,188 @@
+# Moment SDK
+Embeddable calendar sync widget for external team websites. Zero runtime dependencies.
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+---
+## Installation
+Add the SDK via a script tag:
+```html
+<script src="https://unpkg.com/@momentco-ai/moment-sdk"></script>
+```
+Or via npm:
+```bash
+npm install @momentco-ai/moment-sdk
+```
+---
+## Quick Start
+```html
+<!-- 1. Add trigger buttons with data attributes -->
+<button
+  class="moment-sync-trigger"
+  data-moment-team-slug="your-team-slug"
+  data-external-event-id="event-001"
+  data-moment-trigger-type="moment"
+>
+  Add to Calendar
+</button>
+<!-- 2. Load the SDK and initialize -->
+<script src="https://unpkg.com/@momentco-ai/moment-sdk"></script>
+<script>
+  const sdk = new MomentSdk({
+    onSuccess: (result) => console.log('Synced!', result),
+    onError: (result) => console.error('Failed', result),
+    onClose: (result) => console.log('Closed', result),
+  });
+</script>
+```
+That's it — clicking the button opens a modal where users can sync the event to Google Calendar or Outlook.
+See [`examples/basic/`](./examples/basic/) for a complete working example.
+---
+## Init Options
+| Option            | Type                | Required | Description                                                        |
+| ----------------- | ------------------- | -------- | ------------------------------------------------------------------ |
+| `triggerSelector` | `string`            | No       | CSS selector for trigger elements. Default: `.moment-sync-trigger` |
+| `onSuccess`       | `(payload) => void` | No       | Called on successful calendar sync                                 |
+| `onError`         | `(payload) => void` | No       | Called on sync failure                                             |
+| `onClose`         | `(payload) => void` | No       | Called when modal closes (success, error, or cancel)               |
+| `onAnalytics`     | `(event) => void`   | No       | Called for every analytics event                                   |
+---
+## Data Attributes
+Place these on any element matching the trigger selector (default: `.moment-sync-trigger`):
+| Attribute                  | Required | Description                                                  |
+| -------------------------- | -------- | ------------------------------------------------------------ |
+| `data-moment-team-slug`    | ✅       | Team/brand slug                                              |
+| `data-external-event-id`   | No       | Specific event identifier (resolved to real ID by Moment)    |
+| `data-moment-list-slug`    | No       | List slug (resolved to moment IDs by Moment)                 |
+| `data-moment-trigger-type` | No       | `moment` (default), `list`, or `schedule`                    |
+| `data-moment-ids`          | No       | Comma-separated moment IDs (fallback if slugs don't resolve) |
+| `data-moment-game-id`      | No       | Alias for `data-moment-ids`                                  |
+| `data-moment-calendar`     | No       | Pre-select provider: `google` or `outlook`                   |
+---
+## Programmatic API
+You can also open the modal programmatically instead of relying on data attributes:
+```html
+<script>
+  const sdk = new MomentSdk({
+    /* callbacks */
+  });
+  // Open modal
+  sdk.open({
+    teamSlug: 'your-team-slug',
+    externalEventId: 'event-123',
+    triggerType: 'moment',
+    ids: ['moment-id-1'],
+    calendar: 'google', // optional: skip provider selection
+  });
+  // Close modal
+  sdk.close();
+  // Re-bind triggers after dynamic DOM updates
+  sdk.rebind();
+  // Destroy instance entirely
+  sdk.destroy();
+</script>
+```
+---
+## `createMomentButton()`
+Programmatically create a styled trigger button:
+```html
+<script>
+  const btn = createMomentButton({
+    teamSlug: 'your-team-slug',
+    externalEventId: 'event-001',
+    triggerType: 'moment',
+    label: 'Add to Calendar',
+  });
+  document.getElementById('container').appendChild(btn);
+</script>
+```
+The button renders with Moment's default styling (stone-900 background, subtle border, rounded corners). Override with CSS or pass a `className` option.
+---
+## Analytics Events
+The `onAnalytics` callback receives events with these names:
+| Event                 | When                                |
+| --------------------- | ----------------------------------- |
+| `embed.init`          | SDK initialized                     |
+| `embed.trigger.click` | User clicked a trigger button       |
+| `embed.open`          | Modal iframe opened                 |
+| `oauth.start`         | OAuth popup requested               |
+| `oauth.popup.blocked` | Browser blocked the popup           |
+| `oauth.popup.closed`  | User closed popup before completing |
+| `subscribe.success`   | Calendar sync succeeded             |
+| `subscribe.error`     | Calendar sync failed                |
+| `embed.close`         | Modal closed                        |
+---
+## Result Payload
+All callbacks (`onSuccess`, `onError`, `onClose`) receive a result payload:
+```json
+{
+  "source": "moment-live-embed",
+  "type": "moment.embed.result",
+  "result": "success | error | cancelled",
+  "provider": "google | outlook",
+  "triggerType": "moment | list | schedule",
+  "momentIds": ["..."],
+  "message": "optional details"
+}
+```
+---
+## Examples
+See the [`examples/basic/`](./examples/basic/) directory for a complete standalone integration example.
+---
+## Contributing
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and guidelines.
+## Security
+See [SECURITY.md](./SECURITY.md) for reporting vulnerabilities.
+## License
+[MIT](./LICENSE) — Moment Co.

package/dist/moment-sdk.js ADDED Viewed

@@ -0,0 +1 @@

package/dist/moment-sdk.mjs ADDED Viewed

@@ -0,0 +1,342 @@
+class m {
+  popup = null;
+  pollTimer = null;
+  messageHandler = null;
+  resultReceived = !1;
+  opts;
+  constructor(e) {
+    this.opts = e;
+  }
+  /**
+   * Open the OAuth popup in response to a `moment.embed.oauth.start` message.
+   */
+  open(e) {
+    this.cleanup(), this.resultReceived = !1;
+    const t = this.buildPopupUrl(e), s = Math.round(window.screenX + (window.outerWidth - 500) / 2), r = Math.round(window.screenY + (window.outerHeight - 700) / 2);
+    if (this.popup = window.open(
+      t,
+      "moment-oauth-popup",
+      `width=500,height=700,left=${s},top=${r},menubar=no,toolbar=no,location=yes,status=no`
+    ), !this.popup || this.popup.closed) {
+      this.sendStatusToIframe("popup-blocked"), this.opts.onPopupBlocked();
+      return;
+    }
+    this.sendStatusToIframe("popup-opened"), this.startPolling(), this.messageHandler = (i) => {
+      if (i.origin !== this.opts.liveOrigin || i.source !== this.popup) return;
+      const o = i.data;
+      !o || typeof o != "object" || o.source !== "moment-live-embed" || o.type !== "moment.embed.result" || (this.resultReceived = !0, this.sendStatusToIframe("completed"), this.opts.iframeWindow && this.opts.iframeWindow.postMessage(o, this.opts.liveOrigin), this.opts.onResult(o), this.cleanup());
+    }, window.addEventListener("message", this.messageHandler);
+  }
+  /**
+   * Clean up popup, polling, and event listeners.
+   */
+  cleanup() {
+    if (this.pollTimer && (clearInterval(this.pollTimer), this.pollTimer = null), this.messageHandler && (window.removeEventListener("message", this.messageHandler), this.messageHandler = null), this.popup && !this.popup.closed)
+      try {
+        this.popup.close();
+      } catch {
+      }
+    this.popup = null;
+  }
+  buildPopupUrl(e) {
+    const t = window.location.origin, s = new URLSearchParams({
+      provider: e.provider,
+      teamSlug: e.teamSlug,
+      ids: e.ids.join(","),
+      subscriptionType: e.triggerType,
+      returnOrigin: t
+    });
+    return `${this.opts.liveBaseUrl}/en/embed/oauth-popup?${s.toString()}`;
+  }
+  startPolling() {
+    this.pollTimer = setInterval(() => {
+      (!this.popup || this.popup.closed) && (this.pollTimer && (clearInterval(this.pollTimer), this.pollTimer = null), this.resultReceived || (this.sendStatusToIframe("popup-closed"), this.opts.onPopupClosed()), this.cleanup());
+    }, 500);
+  }
+  sendStatusToIframe(e) {
+    if (!this.opts.iframeWindow) return;
+    const t = {
+      source: "moment-sdk",
+      type: "moment.embed.oauth.status",
+      status: e
+    };
+    this.opts.iframeWindow.postMessage(t, this.opts.liveOrigin);
+  }
+}
+const p = ".moment-sync-trigger", h = "https://live.dev.momentco.ai";
+class g {
+  opts;
+  liveBaseUrl;
+  liveOrigin;
+  overlay = null;
+  iframe = null;
+  popupBridge = null;
+  messageHandler = null;
+  boundClickHandlers = /* @__PURE__ */ new Map();
+  activePayload = null;
+  previousFocusedElement = null;
+  previousBodyOverflow = "";
+  didManageBodyOverflow = !1;
+  closeTimer = null;
+  constructor(e) {
+    this.opts = {
+      triggerSelector: p,
+      ...e
+    }, this.liveBaseUrl = h;
+    try {
+      this.liveOrigin = new URL(this.liveBaseUrl).origin;
+    } catch {
+      throw new Error(`[MomentSdk] Invalid VITE_LIVE_BASE_URL: "${this.liveBaseUrl}"`);
+    }
+    this.bindTriggers(), this.emitAnalytics("embed.init");
+  }
+  /**
+   * Programmatically open the sync modal.
+   */
+  open(e) {
+    this.emitAnalytics("embed.open", {
+      teamSlug: e.teamSlug,
+      triggerType: e.triggerType
+    }), this.createModal(e);
+  }
+  /**
+   * Close the modal and clean up all resources.
+   */
+  close() {
+    this.handleCancel();
+  }
+  /**
+   * Re-bind trigger elements (call after dynamic DOM updates).
+   */
+  rebind() {
+    this.unbindTriggers(), this.bindTriggers();
+  }
+  /**
+   * Destroy the SDK instance, removing all event listeners and DOM.
+   */
+  destroy() {
+    this.cleanup(), this.unbindTriggers();
+  }
+  // ── Private: trigger binding ──────────────────────────────────────
+  bindTriggers() {
+    document.querySelectorAll(this.opts.triggerSelector).forEach((t) => {
+      const s = (i) => {
+        i.preventDefault(), this.handleTriggerClick(t);
+      }, r = this.boundClickHandlers.get(t);
+      r && t.removeEventListener("click", r), t.addEventListener("click", s), this.boundClickHandlers.set(t, s);
+    });
+  }
+  unbindTriggers() {
+    this.boundClickHandlers.forEach((e, t) => {
+      t.removeEventListener("click", e);
+    }), this.boundClickHandlers.clear();
+  }
+  handleTriggerClick(e) {
+    const t = e.getAttribute("data-moment-team-slug") ?? "", s = e.getAttribute("data-external-event-id") ?? void 0, r = e.getAttribute("data-moment-list-slug") ?? void 0, i = e.getAttribute("data-moment-trigger-type");
+    let o = "moment";
+    i != null && i !== "" && (i === "moment" || i === "list" || i === "schedule" ? o = i : console.warn(
+      "[MomentSdk] Invalid data-moment-trigger-type, falling back to 'moment':",
+      i
+    ));
+    const l = e.getAttribute("data-moment-ids") ?? e.getAttribute("data-moment-game-id") ?? "", d = l ? l.split(",").filter(Boolean) : [], a = e.getAttribute("data-moment-calendar");
+    let c;
+    if (a != null && a !== "" && (a === "google" || a === "outlook" ? c = a : console.warn("[MomentSdk] Invalid data-moment-calendar, ignoring value:", a)), !t) {
+      console.warn("[MomentSdk] Missing data-moment-team-slug on trigger element");
+      return;
+    }
+    this.emitAnalytics("embed.trigger.click", {
+      teamSlug: t,
+      triggerType: o,
+      momentIds: d
+    }), this.open({
+      teamSlug: t,
+      externalEventId: s,
+      listSlug: r,
+      triggerType: o,
+      ids: d,
+      calendar: c ?? void 0
+    });
+  }
+  // ── Private: modal creation ───────────────────────────────────────
+  createModal(e) {
+    this.cleanup(), this.previousFocusedElement = document.activeElement || null, this.activePayload = e;
+    const t = this.buildIframeUrl(e);
+    this.overlay = document.createElement("div"), this.overlay.setAttribute("role", "presentation"), Object.assign(this.overlay.style, {
+      position: "fixed",
+      inset: "0",
+      zIndex: "999999",
+      display: "flex",
+      alignItems: "center",
+      justifyContent: "center",
+      backgroundColor: "rgba(0, 0, 0, 0.5)",
+      backdropFilter: "blur(2px)",
+      padding: "16px"
+    }), this.overlay.addEventListener("click", (l) => {
+      l.target === this.overlay && this.handleCancel();
+    });
+    const s = (l) => {
+      l.key === "Escape" && this.handleCancel();
+    };
+    document.addEventListener("keydown", s);
+    const r = document.createElement("div");
+    r.setAttribute("role", "dialog"), r.setAttribute("aria-modal", "true"), r.setAttribute("aria-label", "Calendar sync modal"), r.tabIndex = -1, Object.assign(r.style, {
+      position: "relative",
+      width: "100%",
+      maxWidth: "420px",
+      maxHeight: "90vh",
+      borderRadius: "16px",
+      overflow: "hidden",
+      backgroundColor: "#ffffff",
+      boxShadow: "0 25px 50px -12px rgba(0, 0, 0, 0.25)"
+    });
+    const i = document.createElement("button");
+    i.type = "button", i.textContent = "ⓧ", i.setAttribute("aria-label", "Close"), Object.assign(i.style, {
+      position: "absolute",
+      top: "8px",
+      right: "8px",
+      zIndex: "10",
+      border: "none",
+      backgroundColor: "transparent",
+      color: "#999",
+      fontSize: "20px",
+      lineHeight: "1",
+      cursor: "pointer",
+      display: "flex",
+      alignItems: "center",
+      justifyContent: "center"
+    }), i.addEventListener("click", () => this.handleCancel()), this.iframe = document.createElement("iframe"), this.iframe.src = t, this.iframe.setAttribute("allow", ""), this.iframe.setAttribute("sandbox", "allow-scripts allow-same-origin allow-popups allow-forms"), Object.assign(this.iframe.style, {
+      width: "100%",
+      height: "480px",
+      border: "none",
+      display: "block"
+    }), r.appendChild(i), r.appendChild(this.iframe), this.overlay.appendChild(r), document.body.appendChild(this.overlay);
+    const o = (l) => {
+      if (l.key !== "Tab") return;
+      const d = r.querySelectorAll(
+        'button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])'
+      );
+      if (d.length === 0) {
+        l.preventDefault(), r.focus();
+        return;
+      }
+      const a = d[0], c = d[d.length - 1], u = document.activeElement;
+      l.shiftKey && u === a ? (l.preventDefault(), c.focus()) : !l.shiftKey && u === c && (l.preventDefault(), a.focus());
+    };
+    r.addEventListener("keydown", o), i.focus(), this.previousBodyOverflow = document.body.style.overflow, document.body.style.overflow = "hidden", this.didManageBodyOverflow = !0, this.setupMessageListener(), this.overlay._escHandler = s, this.overlay._focusTrapHandler = o;
+  }
+  buildIframeUrl(e) {
+    const t = new URLSearchParams();
+    return t.set("teamSlug", e.teamSlug), e.externalEventId && t.set("momentSlug", e.externalEventId), e.listSlug && t.set("listSlug", e.listSlug), t.set("subscriptionType", e.triggerType), e.ids?.length && t.set("ids", e.ids.join(",")), e.calendar && t.set("calendar", e.calendar), t.set("returnOrigin", window.location.origin), t.set("embed", "1"), `${this.liveBaseUrl}/en/embed/sync?${t.toString()}`;
+  }
+  // ── Private: message handling ─────────────────────────────────────
+  setupMessageListener() {
+    this.messageHandler = (e) => {
+      if (e.origin !== this.liveOrigin || e.source !== this.iframe?.contentWindow) return;
+      const t = e.data;
+      if (!(!t || typeof t != "object")) {
+        if (t.source === "moment-live-embed" && t.type === "moment.embed.oauth.start") {
+          const s = t;
+          this.emitAnalytics("oauth.start", {
+            provider: s.provider,
+            teamSlug: s.teamSlug
+          }), this.handleOAuthStart(s);
+          return;
+        }
+        if (t.source === "moment-live-embed" && t.type === "moment.embed.result") {
+          const s = t;
+          this.handleResult(s);
+        }
+      }
+    }, window.addEventListener("message", this.messageHandler);
+  }
+  handleOAuthStart(e) {
+    this.popupBridge && (this.popupBridge.cleanup(), this.popupBridge = null), this.popupBridge = new m({
+      liveBaseUrl: this.liveBaseUrl,
+      liveOrigin: this.liveOrigin,
+      iframeWindow: this.iframe?.contentWindow ?? null,
+      onResult: (t) => {
+        this.handleResult(t);
+      },
+      onPopupBlocked: () => {
+        this.emitAnalytics("oauth.popup.blocked", {
+          provider: e.provider
+        });
+      },
+      onPopupClosed: () => {
+        this.emitAnalytics("oauth.popup.closed", {
+          provider: e.provider
+        });
+      }
+    }), this.popupBridge.open(e);
+  }
+  handleResult(e) {
+    if (e.result === "success")
+      this.emitAnalytics("subscribe.success", {
+        provider: e.provider,
+        triggerType: e.triggerType,
+        momentIds: e.momentIds
+      }), this.opts.onSuccess?.(e);
+    else if (e.result === "error")
+      this.emitAnalytics("subscribe.error", {
+        provider: e.provider,
+        triggerType: e.triggerType,
+        momentIds: e.momentIds
+      }), this.opts.onError?.(e);
+    else if (e.result === "cancelled")
+      return;
+    this.opts.onClose?.(e), this.emitAnalytics("embed.close"), this.closeTimer = setTimeout(() => this.cleanup(), 1500);
+  }
+  handleCancel() {
+    this.emitAnalytics("embed.close");
+    const e = {
+      source: "moment-live-embed",
+      type: "moment.embed.result",
+      result: "cancelled",
+      triggerType: this.activePayload?.triggerType ?? "moment",
+      momentIds: this.activePayload?.ids ?? []
+    };
+    this.opts.onClose?.(e), this.cleanup();
+  }
+  // ── Private: cleanup ──────────────────────────────────────────────
+  cleanup() {
+    if (this.closeTimer && (clearTimeout(this.closeTimer), this.closeTimer = null), this.popupBridge && (this.popupBridge.cleanup(), this.popupBridge = null), this.messageHandler && (window.removeEventListener("message", this.messageHandler), this.messageHandler = null), this.overlay) {
+      const { _escHandler: e, _focusTrapHandler: t } = this.overlay;
+      e && document.removeEventListener("keydown", e);
+      const s = this.overlay.firstElementChild;
+      s && t && s.removeEventListener("keydown", t), this.overlay.remove(), this.overlay = null;
+    }
+    this.iframe = null, this.activePayload = null, this.didManageBodyOverflow && (document.body.style.overflow = this.previousBodyOverflow, this.didManageBodyOverflow = !1), this.previousFocusedElement && typeof this.previousFocusedElement.focus == "function" && this.previousFocusedElement.focus(), this.previousFocusedElement = null;
+  }
+  // ── Private: analytics ────────────────────────────────────────────
+  emitAnalytics(e, t) {
+    this.opts.onAnalytics?.({
+      event: e,
+      timestamp: Date.now(),
+      ...t
+    });
+  }
+}
+function f(n) {
+  const e = document.createElement("button");
+  return e.type = "button", e.classList.add("moment-sync-trigger"), n.className && n.className.split(" ").forEach((t) => {
+    t && e.classList.add(t);
+  }), Object.assign(e.style, {
+    backgroundColor: "#1c1917",
+    color: "#ffffff",
+    border: "1px solid #292524",
+    borderRadius: "4px",
+    padding: "8px 16px",
+    fontSize: "14px",
+    fontWeight: "500",
+    cursor: "pointer",
+    lineHeight: "1.4"
+  }), e.setAttribute("data-moment-team-slug", n.teamSlug), n.externalEventId && e.setAttribute("data-external-event-id", n.externalEventId), n.listSlug && e.setAttribute("data-moment-list-slug", n.listSlug), n.triggerType && e.setAttribute("data-moment-trigger-type", n.triggerType), n.ids?.length && e.setAttribute("data-moment-ids", n.ids.join(",")), n.calendar && e.setAttribute("data-moment-calendar", n.calendar), e.textContent = n.label ?? "Add to Calendar", e;
+}
+if (typeof window < "u") {
+  const n = window;
+  n.MomentSdk = g, n.createMomentButton = f;
+}
+export {
+  g as MomentSdk,
+  f as createMomentButton
+};

package/dist/types/sdk/button.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+import type { MomentTriggerType, CalendarProvider } from './types';
+/**
+ * Programmatically create a trigger button element with the correct
+ * data attributes for the MomentSdk to bind to.
+ */
+export declare function createMomentButton(options: {
+    teamSlug: string;
+    externalEventId?: string;
+    listSlug?: string;
+    triggerType?: MomentTriggerType;
+    ids?: string[];
+    calendar?: CalendarProvider;
+    label?: string;
+    className?: string;
+}): HTMLButtonElement;

package/dist/types/sdk/index.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+import { MomentSdk } from './moment-sdk';
+import { createMomentButton } from './button';
+export { MomentSdk, createMomentButton };
+export type { MomentSdkInitOptions, MomentSdkOpenPayload, MomentTriggerType, CalendarProvider, MomentResultPayload, MomentOAuthStartPayload, MomentOAuthStatusPayload, MomentAnalyticsEvent, MomentAnalyticsEventName, MomentPostMessage, } from './types';

package/dist/types/sdk/moment-sdk.d.ts ADDED Viewed

@@ -0,0 +1,50 @@
+import type { MomentSdkInitOptions, MomentSdkOpenPayload } from './types';
+/**
+ * MomentSdk — embeddable calendar sync widget.
+ *
+ * Opens a modal iframe to a Moment Live embed route for provider selection,
+ * then bridges OAuth via popup to avoid iframe OAuth restrictions.
+ */
+export declare class MomentSdk {
+    private opts;
+    private liveBaseUrl;
+    private liveOrigin;
+    private overlay;
+    private iframe;
+    private popupBridge;
+    private messageHandler;
+    private boundClickHandlers;
+    private activePayload;
+    private previousFocusedElement;
+    private previousBodyOverflow;
+    private didManageBodyOverflow;
+    private closeTimer;
+    constructor(options: MomentSdkInitOptions);
+    /**
+     * Programmatically open the sync modal.
+     */
+    open(payload: MomentSdkOpenPayload): void;
+    /**
+     * Close the modal and clean up all resources.
+     */
+    close(): void;
+    /**
+     * Re-bind trigger elements (call after dynamic DOM updates).
+     */
+    rebind(): void;
+    /**
+     * Destroy the SDK instance, removing all event listeners and DOM.
+     */
+    destroy(): void;
+    private bindTriggers;
+    private unbindTriggers;
+    private handleTriggerClick;
+    private createModal;
+    private buildIframeUrl;
+    private setupMessageListener;
+    private handleOAuthStart;
+    private handleResult;
+    private handleCancel;
+    private cleanup;
+    private emitAnalytics;
+}

package/dist/types/sdk/popup-bridge.d.ts ADDED Viewed

@@ -0,0 +1,36 @@
+import type { MomentOAuthStartPayload, MomentResultPayload } from './types';
+interface PopupBridgeOptions {
+    liveBaseUrl: string;
+    liveOrigin: string;
+    iframeWindow: Window | null;
+    onResult: (payload: MomentResultPayload) => void;
+    onPopupBlocked: () => void;
+    onPopupClosed: () => void;
+}
+/**
+ * Manages the popup lifecycle for OAuth:
+ * 1. Opens a popup to the Live OAuth route
+ * 2. Polls for popup close
+ * 3. Listens for result postMessage from popup
+ * 4. Relays status to iframe
+ */
+export declare class PopupBridge {
+    private popup;
+    private pollTimer;
+    private messageHandler;
+    private resultReceived;
+    private opts;
+    constructor(opts: PopupBridgeOptions);
+    /**
+     * Open the OAuth popup in response to a `moment.embed.oauth.start` message.
+     */
+    open(payload: MomentOAuthStartPayload): void;
+    /**
+     * Clean up popup, polling, and event listeners.
+     */
+    cleanup(): void;
+    private buildPopupUrl;
+    private startPolling;
+    private sendStatusToIframe;
+}
+export {};

package/dist/types/sdk/types.d.ts ADDED Viewed

@@ -0,0 +1,58 @@
+export type MomentTriggerType = 'moment' | 'list' | 'schedule';
+export type CalendarProvider = 'google' | 'outlook';
+export interface MomentSdkInitOptions {
+    /** CSS selector for trigger elements. Default: ".moment-sync-trigger" */
+    triggerSelector?: string;
+    /** Called when calendar sync completes successfully. */
+    onSuccess?: (payload: MomentResultPayload) => void;
+    /** Called when calendar sync fails. */
+    onError?: (payload: MomentResultPayload) => void;
+    /** Called when the modal is closed (success, error, or cancel). */
+    onClose?: (payload: MomentResultPayload) => void;
+    /** Optional analytics callback for tracking embed events. */
+    onAnalytics?: (event: MomentAnalyticsEvent) => void;
+}
+export interface MomentSdkOpenPayload {
+    teamSlug: string;
+    externalEventId?: string;
+    listSlug?: string;
+    triggerType: MomentTriggerType;
+    ids?: string[];
+    calendar?: CalendarProvider;
+}
+/** Iframe → Parent: request to start OAuth via popup */
+export interface MomentOAuthStartPayload {
+    source: 'moment-live-embed';
+    type: 'moment.embed.oauth.start';
+    provider: CalendarProvider;
+    teamSlug: string;
+    ids: string[];
+    triggerType: MomentTriggerType;
+    returnOrigin: string;
+}
+/** Parent → Iframe: relay OAuth popup status */
+export interface MomentOAuthStatusPayload {
+    source: 'moment-sdk';
+    type: 'moment.embed.oauth.status';
+    status: 'popup-opened' | 'popup-blocked' | 'popup-closed' | 'completed';
+}
+/** Result payload (popup → parent, or iframe → parent for cancel) */
+export interface MomentResultPayload {
+    source: 'moment-live-embed';
+    type: 'moment.embed.result';
+    result: 'success' | 'error' | 'cancelled';
+    provider?: CalendarProvider;
+    triggerType: MomentTriggerType;
+    momentIds: string[];
+    message?: string;
+}
+export type MomentAnalyticsEventName = 'embed.init' | 'embed.trigger.click' | 'embed.open' | 'oauth.start' | 'oauth.popup.blocked' | 'oauth.popup.closed' | 'subscribe.success' | 'subscribe.error' | 'embed.close';
+export interface MomentAnalyticsEvent {
+    event: MomentAnalyticsEventName;
+    provider?: CalendarProvider;
+    teamSlug?: string;
+    triggerType?: MomentTriggerType;
+    momentIds?: string[];
+    timestamp: number;
+}
+export type MomentPostMessage = MomentOAuthStartPayload | MomentOAuthStatusPayload | MomentResultPayload;

package/package.json ADDED Viewed

@@ -0,0 +1,70 @@
+{
+  "name": "@momentco-ai/moment-sdk",
+  "version": "0.1.0-dev.1",
+  "type": "module",
+  "description": "Embeddable calendar sync widget for external team websites",
+  "author": "Moment Co. <support@momentco.ai> (https://momentco.ai)",
+  "license": "MIT",
+  "homepage": "https://github.com/Moment-Co/moment-sdk#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Moment-Co/moment-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Moment-Co/moment-sdk/issues"
+  },
+  "keywords": [
+    "calendar",
+    "sync",
+    "embed",
+    "widget",
+    "google-calendar",
+    "outlook",
+    "moment"
+  ],
+  "packageManager": "pnpm@9.15.5",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "main": "dist/moment-sdk.js",
+  "module": "dist/moment-sdk.mjs",
+  "unpkg": "dist/moment-sdk.js",
+  "jsdelivr": "dist/moment-sdk.js",
+  "types": "dist/types/sdk/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/sdk/index.d.ts",
+      "import": "./dist/moment-sdk.mjs",
+      "default": "./dist/moment-sdk.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "vite build && tsc --emitDeclarationOnly --outDir dist/types",
+    "build:dev": "vite build --mode development && tsc --emitDeclarationOnly --outDir dist/types",
+    "build:prod": "vite build --mode production && tsc --emitDeclarationOnly --outDir dist/types",
+    "type-check": "tsc --noEmit",
+    "typecheck": "pnpm run type-check",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "quality": "pnpm run type-check && pnpm run lint && pnpm run format",
+    "prepare": "husky"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.25.0",
+    "eslint": "^9.25.0",
+    "husky": "^9.1.7",
+    "prettier": "^3.2.5",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.32.1",
+    "vite": "^7.1.5"
+  }
+}