sunsama-api 0.1.0

package/dist/esm/queries/user.js

@@ -0,0 +1,469 @@
+/**
+ * User-related GraphQL queries
+ */
+import { gql } from 'graphql-tag';
+export const GET_USER_QUERY = gql `
+  query getUser {
+    currentUser {
+      _id
+      activationDate
+      admin
+      aka
+      calendar {
+        items {
+          id
+          accountId
+          google {
+            summary
+            summaryOverride
+            timeZone
+            selected
+            accessRole
+            accountId
+            __typename
+          }
+          microsoft {
+            id
+            name
+            color
+            hexColor
+            isDefaultCalendar
+            canShare
+            canViewPrivateItems
+            canEdit
+            isRemovable
+            allowedOnlineMeetingProviders
+            defaultOnlineMeetingProvider
+            isTallyingResponse
+            owner {
+              address
+              name
+              __typename
+            }
+            primary
+            accountId
+            __typename
+          }
+          __typename
+        }
+        __typename
+      }
+      services {
+        google {
+          scope
+          id
+          email
+          name
+          picture
+          locale
+          __typename
+        }
+        microsoft {
+          scope
+          id
+          email
+          name
+          isPersonalAccount
+          __typename
+        }
+        phoneNumber {
+          number
+          verified
+          otpExpiresAt
+          __typename
+        }
+        ssoEnforced
+        __typename
+      }
+      emails {
+        address
+        verified
+        __typename
+      }
+      primaryGroup {
+        groupId
+        __typename
+      }
+      onboarding
+      preferences {
+        clockStyle
+        defaultCalendarView
+        defaultHomeView
+        defaultMainPanel
+        defaultMobileCalendarView
+        defaultHideTasks
+        hideTeamEvtCopies
+        hideMessenger
+        disableSpellcheck
+        channelRecommendations
+        plannedTimeRecommendations
+        subtaskPlannedTimeRecommendations
+        startDayOfWeekOffset
+        workingSessionTransparency
+        workingSessionVisibility
+        workingSessionDuration
+        promptToUpdateStatus
+        darkMode
+        keyboardShortcuts
+        customKeyboardShortcuts {
+          id
+          disabled
+          global
+          key
+          metaKey
+          ctrlKey
+          shiftKey
+          __typename
+        }
+        autoArchiveThreshold
+        showDeclinedEvents
+        usePlannedTimeAsActualTime
+        rollToTop
+        includeWeekendInReflection
+        planningAutoRollover
+        autoFocus
+        focusBarDisabledTriggers
+        workloadThreshold
+        importEventFilters
+        autoImportEvents
+        importEventCompletionSync
+        workingSessionCalendarReminder
+        workingSessionBuffer
+        focusModeNextUpReminder
+        autoRescheduleWorkingSessionConflicts
+        autoRescheduleWorkingSessionCompletions
+        schedulingHours {
+          start {
+            hour
+            minute
+            __typename
+          }
+          end {
+            hour
+            minute
+            __typename
+          }
+          __typename
+        }
+        defaultEmailClient
+        timerNotificationsEnabled
+        timerNotificationsSoundId
+        timerPomodoroNotificationsSoundId
+        timerNotificationsVolume
+        timerNotificationsTimeRemainingTriggers
+        endOfDayMessageId
+        endOfDayCustomMessage
+        autoBreak
+        defaultTargetFocusDuration
+        defaultTargetBreakDuration
+        defaultFocusTimerView
+        completedTaskCalendarPinStyle
+        hideCompletedTasks
+        insertTaskPosition
+        chatToolFocusSyncTrigger
+        chatToolFocusSyncUpdateStatus
+        chatToolFocusSyncUpdateDnd
+        chatToolFocusSyncPrivacy
+        chatToolFocusSyncStatusEmoji
+        navigationPanelStyle
+        preferredAILanguage
+        preferredLanguage
+        visualizeTaskProjectedTimeOnCalendar
+        visualizeTaskActualTimeOnCalendar
+        __typename
+      }
+      contacts {
+        integrationEnabled
+        usesNewPeopleApi
+        accountId
+        __typename
+      }
+      createdAt
+      dailyPlanning {
+        snoozedUntilDate
+        lastDayPlanned
+        disabledSteps
+        importEventsWithoutInvitees
+        __typename
+      }
+      dailyShutdown {
+        snoozedUntilDate
+        lastDayShutdown
+        __typename
+      }
+      daysPlanned
+      daysShutdown
+      desktopApp {
+        darwin {
+          status
+          deferralDate
+          __typename
+        }
+        win32 {
+          status
+          deferralDate
+          __typename
+        }
+        linux {
+          status
+          deferralDate
+          __typename
+        }
+        __typename
+      }
+      mobileApp {
+        status
+        os
+        lastModified
+        __typename
+      }
+      lastAnnouncementCheckDate
+      lastModified
+      nodeId
+      notifySettings {
+        inviteeResponse {
+          subscribed
+          channels
+          __typename
+        }
+        invitedToEvent {
+          subscribed
+          channels
+          __typename
+        }
+        eventUpdated {
+          subscribed
+          channels
+          __typename
+        }
+        eventCancelled {
+          subscribed
+          channels
+          __typename
+        }
+        newComments {
+          subscribed
+          channels
+          __typename
+        }
+        shareTasks {
+          subscribed
+          channels
+          __typename
+        }
+        taskComment {
+          subscribed
+          channels
+          __typename
+        }
+        taskStream {
+          subscribed
+          channels
+          __typename
+        }
+        taskAssignee {
+          subscribed
+          channels
+          __typename
+        }
+        taskCompletion {
+          subscribed
+          channels
+          __typename
+        }
+        taskSchedule {
+          subscribed
+          channels
+          __typename
+        }
+        taskCreation {
+          subscribed
+          channels
+          __typename
+        }
+        eventReminders {
+          subscribed
+          channels
+          __typename
+        }
+        dossier {
+          subscribed
+          channels
+          __typename
+        }
+        planYourDay {
+          subscribed
+          channels
+          __typename
+        }
+        weeklyStats {
+          subscribed
+          channels
+          __typename
+        }
+        weekReview {
+          subscribed
+          channels
+          __typename
+        }
+        systemUpdates {
+          subscribed
+          channels
+          __typename
+        }
+        dailyWrapSeen {
+          subscribed
+          channels
+          __typename
+        }
+        dailyWrapReply {
+          subscribed
+          channels
+          __typename
+        }
+        __typename
+      }
+      profile {
+        profilePictureURL
+        firstname
+        lastname
+        timezone
+        timezoneWarningDisabled
+        profileThumbs {
+          image_24
+          image_32
+          image_48
+          image_72
+          image_192
+          __typename
+        }
+        useCase
+        onboardingEventSent
+        __typename
+      }
+      toursCompleted
+      username
+      waitList
+      weeklyPlanning {
+        hour
+        minute
+        isoWeekday
+        lastWeekPlanned
+        weeksPlanned
+        disabled
+        __typename
+      }
+      weeklyReview {
+        hour
+        minute
+        isoWeekday
+        lastWeekReviewed
+        weeksReviewed
+        disabled
+        __typename
+      }
+      lastArchiveCheckDate
+      integrationRequests
+      dayStart {
+        hour
+        minute
+        disabled
+        __typename
+      }
+      plannedDayStart {
+        hour
+        minute
+        disabled
+        __typename
+      }
+      dayEnd {
+        hour
+        minute
+        disabled
+        __typename
+      }
+      waitlistId
+      trialPeriod
+      qualificationAssessment
+      disappointmentIndex
+      emailCourses {
+        id
+        status
+        __typename
+      }
+      tracking {
+        facebook {
+          _fbp
+          _fbc
+          __typename
+        }
+        chatSetupConfigId
+        __typename
+      }
+      proficiencies {
+        id
+        count
+        proficient
+        proficientAt
+        firstPerformedAt
+        __typename
+      }
+      assistant {
+        scheduledCalls {
+          workflow
+          reminder {
+            schedule {
+              enabled
+              isoDayIndex
+              time {
+                hour
+                minute
+                __typename
+              }
+              __typename
+            }
+            __typename
+          }
+          __typename
+        }
+        __typename
+      }
+      dailyWrap {
+        reminder {
+          schedule {
+            enabled
+            isoDayIndex
+            time {
+              hour
+              minute
+              __typename
+            }
+            __typename
+          }
+          nextDeliveryAt
+          __typename
+        }
+        __typename
+      }
+      dailyCatchUp {
+        reminder {
+          schedule {
+            enabled
+            isoDayIndex
+            time {
+              hour
+              minute
+              __typename
+            }
+            __typename
+          }
+          nextDeliveryAt
+          __typename
+        }
+        __typename
+      }
+      __typename
+    }
+  }
+`;
+//# sourceMappingURL=user.js.map

package/dist/esm/queries/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../../src/queries/user.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+chC,CAAC"}

package/dist/esm/types/api.js

@@ -0,0 +1,8 @@
+/**
+ * API response and data types
+ *
+ * These types represent the structure of data returned by the Sunsama API.
+ * They will be populated based on the actual API documentation.
+ */
+export {};
+//# sourceMappingURL=api.js.map

package/dist/esm/types/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/types/api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/esm/types/client.js

@@ -0,0 +1,5 @@
+/**
+ * Client configuration and related types
+ */
+export {};
+//# sourceMappingURL=client.js.map

package/dist/esm/types/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/types/client.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/esm/types/common.js

@@ -0,0 +1,5 @@
+/**
+ * Common utility types used throughout the library
+ */
+export {};
+//# sourceMappingURL=common.js.map

package/dist/esm/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/types/common.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/esm/types/index.js

@@ -0,0 +1,7 @@
+/**
+ * Type definitions for the Sunsama API wrapper
+ *
+ * This file exports all type definitions used throughout the library.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/esm/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/esm/utils/index.js

@@ -0,0 +1,57 @@
+/**
+ * Utility functions for the Sunsama API wrapper
+ */
+/**
+ * Validates that a string is not empty
+ *
+ * @param value - The string to validate
+ * @param fieldName - Name of the field (for error messages)
+ * @throws {Error} If the string is empty or only whitespace
+ */
+export function validateNonEmptyString(value, fieldName) {
+    if (!value || value.trim().length === 0) {
+        throw new Error(`${fieldName} cannot be empty`);
+    }
+}
+/**
+ * Validates that a number is positive
+ *
+ * @param value - The number to validate
+ * @param fieldName - Name of the field (for error messages)
+ * @throws {Error} If the number is not positive
+ */
+export function validatePositiveNumber(value, fieldName) {
+    if (value <= 0) {
+        throw new Error(`${fieldName} must be a positive number`);
+    }
+}
+/**
+ * Builds a URL with query parameters
+ *
+ * @param baseUrl - The base URL
+ * @param params - Query parameters to append
+ * @returns The complete URL with query string
+ */
+export function buildUrlWithParams(baseUrl, params) {
+    if (!params || Object.keys(params).length === 0) {
+        return baseUrl;
+    }
+    const url = new URL(baseUrl);
+    Object.entries(params).forEach(([key, value]) => {
+        url.searchParams.append(key, String(value));
+    });
+    return url.toString();
+}
+/**
+ * Checks if a value is a plain object
+ *
+ * @param value - The value to check
+ * @returns True if the value is a plain object
+ */
+export function isPlainObject(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value.constructor === Object &&
+        Object.prototype.toString.call(value) === '[object Object]');
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa,EAAE,SAAiB;IACrE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,kBAAkB,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa,EAAE,SAAiB;IACrE,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,4BAA4B,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,MAAkD;IAElD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAE7B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC9C,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,WAAW,KAAK,MAAM;QAC5B,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,iBAAiB,CAC5D,CAAC;AACJ,CAAC"}

package/dist/types/client/index.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Main Sunsama API client
+ *
+ * Provides a type-safe interface to interact with all Sunsama API endpoints.
+ */
+import type { Stream, SunsamaClientConfig, Task, User } from '../types';
+/**
+ * Main Sunsama API client class
+ *
+ * Provides a type-safe interface to interact with all Sunsama API endpoints.
+ */
+export declare class SunsamaClient {
+    private static readonly BASE_URL;
+    private readonly config;
+    private readonly cookieJar;
+    private userId?;
+    private groupId?;
+    private timezone?;
+    /**
+     * Creates a new Sunsama client instance
+     *
+     * @param config - Client configuration options (optional)
+     */
+    constructor(config?: SunsamaClientConfig);
+    /**
+     * Gets the current client configuration
+     */
+    getConfig(): SunsamaClientConfig;
+    /**
+     * Checks if the client is authenticated
+     *
+     * @returns True if cookies are present in the jar
+     */
+    isAuthenticated(): Promise<boolean>;
+    /**
+     * Authenticates with email and password
+     *
+     * @param email - User email address
+     * @param password - User password
+     * @throws SunsamaAuthError if login fails
+     */
+    login(email: string, password: string): Promise<void>;
+    /**
+     * Clears all cookies from the jar and cached user data
+     */
+    logout(): void;
+    /**
+     * Makes an authenticated request to the Sunsama API
+     *
+     * @param path - The API endpoint path (e.g., '/tasks')
+     * @param options - Request options
+     * @returns The response from the API
+     * @internal
+     */
+    private request;
+    /**
+     * Makes a GraphQL request to the Sunsama API
+     *
+     * @param request - The GraphQL request
+     * @returns The GraphQL response
+     * @internal
+     */
+    private graphqlRequest;
+    /**
+     * Gets the current user information
+     *
+     * @returns The current user data
+     * @throws SunsamaAuthError if not authenticated or request fails
+     */
+    getUser(): Promise<User>;
+    /**
+     * Gets tasks for a specific day
+     *
+     * @param day - ISO date string (e.g., "2025-05-31")
+     * @param timezone - Timezone string (e.g., "America/New_York", defaults to user's timezone)
+     * @returns Array of tasks for the specified day
+     * @throws SunsamaAuthError if not authenticated or request fails
+     */
+    getTasksByDay(day: string, timezone?: string): Promise<Task[]>;
+    /**
+     * Gets tasks from the backlog
+     *
+     * @returns Array of backlog tasks
+     * @throws SunsamaAuthError if not authenticated or request fails
+     */
+    getTasksBacklog(): Promise<Task[]>;
+    /**
+     * Gets streams for the user's group
+     *
+     * @returns Array of streams for the user's group
+     * @throws SunsamaAuthError if not authenticated or request fails
+     */
+    getStreamsByGroupId(): Promise<Stream[]>;
+    /**
+     * Gets the user's timezone
+     *
+     * @returns The user's timezone string (e.g., "America/New_York")
+     * @throws SunsamaAuthError if not authenticated or request fails
+     */
+    getUserTimezone(): Promise<string>;
+    /**
+     * Sets a session token as a cookie in the jar
+     *
+     * @param token - The session token to set
+     * @internal
+     */
+    private setSessionTokenAsCookie;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,KAAK,EAUV,MAAM,EACN,mBAAmB,EACnB,IAAI,EACJ,IAAI,EACL,MAAM,UAAU,CAAC;AAElB;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IAE7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAE1B;;;;OAIG;gBACS,MAAM,GAAE,mBAAwB;IAU5C;;OAEG;IACH,SAAS,IAAI,mBAAmB;IAIhC;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAKzC;;;;;;OAMG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoE3D;;OAEG;IACH,MAAM,IAAI,IAAI;IAOd;;;;;;;OAOG;YACW,OAAO;IAyCrB;;;;;;OAMG;YACW,cAAc;IAqC5B;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB9B;;;;;;;OAOG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAuCpE;;;;;OAKG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAkCxC;;;;;OAKG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA6B9C;;;;;OAKG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAexC;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;CAiBhC"}