@davidwoods/skylight-mcp 0.0.0-stage → 1.8.0

package/dist/api/endpoints/messages.js

@@ -0,0 +1,116 @@
+import { getClient } from "../client.js";
+import { addDays, offsetAt, zonedToEpoch } from "../../utils/schedule.js";
+/**
+ * Messages need the API version the web app sends. Under the repo-wide older
+ * version the responses omit all_profiles / all_devices / voice_kind, which
+ * made get_messages misreport recipients and the edit guard refuse everything.
+ */
+export const NUDGES_API_VERSION = "2026-10-15";
+/** ISO-8601 with the zone's numeric offset, e.g. 2026-10-01T00:00:00.000-07:00. */
+export function isoWithOffset(epochMs, timeZone) {
+    const offsetMin = Math.round(offsetAt(epochMs, timeZone) / 60_000);
+    const sign = offsetMin < 0 ? "-" : "+";
+    const abs = Math.abs(offsetMin);
+    const hh = String(Math.floor(abs / 60)).padStart(2, "0");
+    const mm = String(abs % 60).padStart(2, "0");
+    const local = new Date(epochMs + offsetMin * 60_000).toISOString().slice(0, 23);
+    return `${local}${sign}${hh}:${mm}`;
+}
+/** Messages delivered between two local dates, inclusive. */
+export async function getNudges(startDate, endDate, timeZone) {
+    const after = isoWithOffset(zonedToEpoch(startDate, "00:00", timeZone), timeZone);
+    const before = isoWithOffset(zonedToEpoch(addDays(endDate, 1), "00:00", timeZone) - 1, timeZone);
+    const response = await getClient().request("/api/frames/{frameId}/nudges", {
+        method: "GET",
+        params: { after, before },
+        apiVersion: NUDGES_API_VERSION,
+    });
+    return response.data ?? [];
+}
+/**
+ * Send a message to every profile and every device, delivered now.
+ * Payload shape is from the web app's "Send Now" call. Targeting specific
+ * profiles is inferred from how Skylight stores a message sent to one profile
+ * (all_profiles false plus that profile in categories) and from another open
+ * source client that sends category_ids; the POST itself has not been captured.
+ * Targeting devices and scheduling are not offered.
+ */
+export async function createNudge(options) {
+    const payload = {
+        body: options.body,
+        deliver_at: isoWithOffset(Date.now(), options.timeZone),
+        all_profiles: !options.recipientCategoryIds?.length,
+        all_devices: true,
+        voice_kind: options.readAloud ? "kirk_voice" : "silent",
+    };
+    if (options.recipientCategoryIds?.length)
+        payload.category_ids = options.recipientCategoryIds;
+    if (options.senderCategoryId)
+        payload.sender_category_id = options.senderCategoryId;
+    const response = await getClient().request("/api/frames/{frameId}/nudges", {
+        method: "POST",
+        body: payload,
+        apiVersion: NUDGES_API_VERSION,
+    });
+    const data = response?.data;
+    return Array.isArray(data) ? (data[0] ?? null) : (data ?? null);
+}
+/** Message ids are numeric. Validate before one ever reaches a URL path. */
+export function assertNudgeId(id) {
+    if (!/^\d{1,12}$/.test(id))
+        throw new Error("Message ID must be numeric (see get_messages).");
+    return id;
+}
+/** Find one message by id within +/- 31 days of today. */
+export async function findNudge(id, timeZone) {
+    const today = new Date();
+    const day = (offset) => {
+        const d = new Date(today.getTime() + offset * 86_400_000);
+        return d.toLocaleDateString("en-CA", { timeZone });
+    };
+    const nudges = await getNudges(day(-31), day(31), timeZone);
+    return nudges.find((n) => n.id === id) ?? null;
+}
+/**
+ * Edit a message the way the web app does: PATCH with the whole form.
+ * Only messages sent to everyone on all devices and not repeating are
+ * supported, because those are the only shapes captured.
+ */
+export async function updateNudge(options) {
+    const { existing } = options;
+    const a = existing.attributes;
+    if (a.all_profiles !== true || a.all_devices !== true || a.recurring === true || a.rrule) {
+        throw new Error("Only messages sent to everyone on all devices, and not repeating, can be edited here. Edit this one in the Skylight app.");
+    }
+    const deliverAt = Date.parse(a.deliver_at ?? "");
+    if (Number.isNaN(deliverAt))
+        throw new Error("Message has no delivery time; edit it in the Skylight app.");
+    const sender = options.senderCategoryId ?? existing.relationships?.sender_category?.data?.id;
+    const payload = {
+        body: options.body,
+        deliver_at: isoWithOffset(deliverAt, options.timeZone),
+        all_profiles: true,
+        all_devices: true,
+        voice_kind: a.voice_kind ?? "silent",
+    };
+    if (sender)
+        payload.sender_category_id = sender;
+    await getClient().request(`/api/frames/{frameId}/nudges/${assertNudgeId(existing.id)}`, {
+        method: "PATCH",
+        body: payload,
+        apiVersion: NUDGES_API_VERSION,
+    });
+}
+/**
+ * Delete a message: DELETE /nudges/{id}. The Skylight web app offers no delete
+ * button, so this call is taken from two other open-source clients and has not
+ * been confirmed against this account's API version until a live run says so.
+ * Returns the HTTP outcome only; callers must read back to confirm removal.
+ */
+export async function deleteNudge(existing) {
+    await getClient().request(`/api/frames/{frameId}/nudges/${assertNudgeId(existing.id)}`, {
+        method: "DELETE",
+        apiVersion: NUDGES_API_VERSION,
+    });
+}
+//# sourceMappingURL=messages.js.map

package/dist/api/endpoints/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../src/api/endpoints/messages.ts"],"names":[],"mappings":"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"}

package/dist/api/endpoints/misc.d.ts

@@ -0,0 +1,27 @@
+export interface AvatarResource {
+    type: "avatar";
+    id: string;
+    attributes: {
+        name?: string;
+        url?: string;
+        [key: string]: unknown;
+    };
+}
+export interface ColorResource {
+    type: "color";
+    id: string;
+    attributes: {
+        name?: string;
+        hex?: string;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Get available avatar options
+ */
+export declare function getAvatars(): Promise<AvatarResource[]>;
+/**
+ * Get available color options
+ */
+export declare function getColors(): Promise<ColorResource[]>;
+//# sourceMappingURL=misc.d.ts.map

package/dist/api/endpoints/misc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../../src/api/endpoints/misc.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE;QACV,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE;QACV,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAUD;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAI5D;AAED;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAI1D"}

package/dist/api/endpoints/misc.js

@@ -0,0 +1,19 @@
+import { getClient } from "../client.js";
+import { resourceList } from "./shape.js";
+/**
+ * Get available avatar options
+ */
+export async function getAvatars() {
+    const client = getClient();
+    const response = await client.get("/api/avatars");
+    return response.data;
+}
+/**
+ * Get available color options
+ */
+export async function getColors() {
+    const client = getClient();
+    const response = await client.get("/api/colors");
+    return resourceList(response, "colors");
+}
+//# sourceMappingURL=misc.js.map

package/dist/api/endpoints/misc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.js","sourceRoot":"","sources":["../../../src/api/endpoints/misc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA8B1C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAkB,cAAc,CAAC,CAAC;IACnE,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAiB,aAAa,CAAC,CAAC;IACjE,OAAO,YAAY,CAAgB,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC"}

package/dist/api/endpoints/photos.d.ts

@@ -0,0 +1,13 @@
+export interface AlbumResource {
+    type: "album";
+    id: string;
+    attributes: {
+        name?: string;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Get photo albums
+ */
+export declare function getAlbums(): Promise<AlbumResource[]>;
+//# sourceMappingURL=photos.d.ts.map

package/dist/api/endpoints/photos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photos.d.ts","sourceRoot":"","sources":["../../../src/api/endpoints/photos.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE;QACV,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAMD;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAI1D"}

package/dist/api/endpoints/photos.js

@@ -0,0 +1,10 @@
+import { getClient } from "../client.js";
+/**
+ * Get photo albums
+ */
+export async function getAlbums() {
+    const client = getClient();
+    const response = await client.get("/api/frames/{frameId}/albums");
+    return response.data;
+}
+//# sourceMappingURL=photos.js.map

package/dist/api/endpoints/photos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"photos.js","sourceRoot":"","sources":["../../../src/api/endpoints/photos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAezC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAiB,8BAA8B,CAAC,CAAC;IAClF,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC"}

package/dist/api/endpoints/rewards.d.ts

@@ -0,0 +1,49 @@
+import type { RewardResource, RewardPointResource } from "../types.js";
+export interface GetRewardsOptions {
+    redeemedAtMin?: string;
+}
+/**
+ * Get rewards (items that can be redeemed with points)
+ */
+export declare function getRewards(options?: GetRewardsOptions): Promise<RewardResource[]>;
+/**
+ * Get reward points for family members
+ */
+export declare function getRewardPoints(): Promise<RewardPointResource[]>;
+export interface CreateRewardOptions {
+    name: string;
+    pointValue: number;
+    description?: string;
+    emojiIcon?: string;
+    categoryIds?: string[];
+    respawnOnRedemption?: boolean;
+}
+/**
+ * Create a new reward
+ */
+export declare function createReward(options: CreateRewardOptions): Promise<RewardResource>;
+export interface UpdateRewardOptions {
+    name?: string;
+    pointValue?: number;
+    description?: string | null;
+    emojiIcon?: string | null;
+    categoryIds?: string[];
+    respawnOnRedemption?: boolean;
+}
+/**
+ * Update an existing reward
+ */
+export declare function updateReward(rewardId: string, options: UpdateRewardOptions): Promise<RewardResource>;
+/**
+ * Delete a reward
+ */
+export declare function deleteReward(rewardId: string): Promise<void>;
+/**
+ * Redeem a reward (spend points)
+ */
+export declare function redeemReward(rewardId: string, categoryId?: string): Promise<RewardResource>;
+/**
+ * Unredeem a reward (cancel redemption)
+ */
+export declare function unredeemReward(rewardId: string): Promise<RewardResource>;
+//# sourceMappingURL=rewards.d.ts.map

package/dist/api/endpoints/rewards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewards.d.ts","sourceRoot":"","sources":["../../../src/api/endpoints/rewards.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,cAAc,EAGd,mBAAmB,EAGpB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAS3F;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAMtE;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyBxF;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,CA8BzB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKlE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC,CAQzB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAO9E"}

package/dist/api/endpoints/rewards.js

@@ -0,0 +1,106 @@
+import { resourceList } from "./shape.js";
+import { getClient } from "../client.js";
+/**
+ * Get rewards (items that can be redeemed with points)
+ */
+export async function getRewards(options = {}) {
+    const client = getClient();
+    const response = await client.get("/api/frames/{frameId}/rewards", {
+        redeemed_at_min: options.redeemedAtMin,
+    });
+    return response.data;
+}
+/**
+ * Get reward points for family members
+ */
+export async function getRewardPoints() {
+    const client = getClient();
+    const response = await client.get("/api/frames/{frameId}/reward_points");
+    return resourceList(response, "reward points");
+}
+/**
+ * Create a new reward
+ */
+export async function createReward(options) {
+    const client = getClient();
+    const request = {
+        data: {
+            type: "reward",
+            attributes: {
+                name: options.name,
+                point_value: options.pointValue,
+                description: options.description ?? null,
+                emoji_icon: options.emojiIcon ?? null,
+                respawn_on_redemption: options.respawnOnRedemption ?? false,
+            },
+        },
+    };
+    if (options.categoryIds && options.categoryIds.length > 0) {
+        request.data.relationships = {
+            categories: {
+                data: options.categoryIds.map((id) => ({ type: "category", id })),
+            },
+        };
+    }
+    const response = await client.post("/api/frames/{frameId}/rewards", request);
+    return response.data;
+}
+/**
+ * Update an existing reward
+ */
+export async function updateReward(rewardId, options) {
+    const client = getClient();
+    const request = {
+        data: {
+            type: "reward",
+            attributes: {},
+        },
+    };
+    if (options.name !== undefined)
+        request.data.attributes.name = options.name;
+    if (options.pointValue !== undefined)
+        request.data.attributes.point_value = options.pointValue;
+    if (options.description !== undefined)
+        request.data.attributes.description = options.description;
+    if (options.emojiIcon !== undefined)
+        request.data.attributes.emoji_icon = options.emojiIcon;
+    if (options.respawnOnRedemption !== undefined) {
+        request.data.attributes.respawn_on_redemption = options.respawnOnRedemption;
+    }
+    if (options.categoryIds) {
+        request.data.relationships = {
+            categories: {
+                data: options.categoryIds.map((id) => ({ type: "category", id })),
+            },
+        };
+    }
+    const response = await client.request(`/api/frames/{frameId}/rewards/${rewardId}`, { method: "PATCH", body: request });
+    return response.data;
+}
+/**
+ * Delete a reward
+ */
+export async function deleteReward(rewardId) {
+    const client = getClient();
+    await client.request(`/api/frames/{frameId}/rewards/${rewardId}`, {
+        method: "DELETE",
+    });
+}
+/**
+ * Redeem a reward (spend points)
+ */
+export async function redeemReward(rewardId, categoryId) {
+    const client = getClient();
+    const body = categoryId ? { category_id: categoryId } : {};
+    const response = await client.post(`/api/frames/{frameId}/rewards/${rewardId}/redeem`, body);
+    return response.data;
+}
+/**
+ * Unredeem a reward (cancel redemption)
+ */
+export async function unredeemReward(rewardId) {
+    const client = getClient();
+    const response = await client.post(`/api/frames/{frameId}/rewards/${rewardId}/unredeem`, {});
+    return response.data;
+}
+//# sourceMappingURL=rewards.js.map

package/dist/api/endpoints/rewards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewards.js","sourceRoot":"","sources":["../../../src/api/endpoints/rewards.ts"],"names":[],"mappings":"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"}

package/dist/api/endpoints/shape.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Normalise a list response. Skylight's endpoints mostly return JSON:API
+ * ({ data: [...] }), but a few (colors, reward points) did not match that on a
+ * real account. Accept a bare array, { data: [...] } or { data: {...} }; for
+ * anything else fail with the top-level KEYS only (never values, which can
+ * hold personal data) so the real shape can be learned from the error.
+ */
+export declare function resourceList<T>(response: unknown, label: string): T[];
+/** Attributes of a resource, tolerating flat items that carry no `attributes`. */
+export declare function attributesOf(item: unknown): Record<string, unknown>;
+//# sourceMappingURL=shape.d.ts.map

package/dist/api/endpoints/shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.d.ts","sourceRoot":"","sources":["../../../src/api/endpoints/shape.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,CAUrE;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQnE"}

package/dist/api/endpoints/shape.js

@@ -0,0 +1,34 @@
+/**
+ * Normalise a list response. Skylight's endpoints mostly return JSON:API
+ * ({ data: [...] }), but a few (colors, reward points) did not match that on a
+ * real account. Accept a bare array, { data: [...] } or { data: {...} }; for
+ * anything else fail with the top-level KEYS only (never values, which can
+ * hold personal data) so the real shape can be learned from the error.
+ */
+export function resourceList(response, label) {
+    if (Array.isArray(response))
+        return response;
+    if (response && typeof response === "object") {
+        const data = response.data;
+        if (Array.isArray(data))
+            return data;
+        if (data && typeof data === "object")
+            return [data];
+        const keys = Object.keys(response).join(", ") || "none";
+        throw new Error(`${label}: unexpected response shape (top-level keys: ${keys})`);
+    }
+    throw new Error(`${label}: unexpected response shape (${typeof response})`);
+}
+/** Attributes of a resource, tolerating flat items that carry no `attributes`. */
+export function attributesOf(item) {
+    if (!item || typeof item !== "object")
+        return {};
+    const obj = item;
+    if (obj.attributes && typeof obj.attributes === "object")
+        return obj.attributes;
+    const rest = { ...item };
+    delete rest.id;
+    delete rest.type;
+    return rest;
+}
+//# sourceMappingURL=shape.js.map

package/dist/api/endpoints/shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.js","sourceRoot":"","sources":["../../../src/api/endpoints/shape.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAI,QAAiB,EAAE,KAAa;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAe,CAAC;IACpD,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAI,QAA+B,CAAC,IAAI,CAAC;QACnD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,OAAO,IAAW,CAAC;QAC5C,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,CAAC,IAAS,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,gDAAgD,IAAI,GAAG,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,gCAAgC,OAAO,QAAQ,GAAG,CAAC,CAAC;AAC9E,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACjD,MAAM,GAAG,GAAG,IAAgC,CAAC;IAC7C,IAAI,GAAG,CAAC,UAAU,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,UAAqC,CAAC;IAC3G,MAAM,IAAI,GAA4B,EAAE,GAAI,IAAgC,EAAE,CAAC;IAC/E,OAAO,IAAI,CAAC,EAAE,CAAC;IACf,OAAO,IAAI,CAAC,IAAI,CAAC;IACjB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/api/endpoints/taskbox.d.ts

@@ -0,0 +1,21 @@
+import type { TaskBoxItemResource } from "../types.js";
+export interface CreateTaskBoxItemOptions {
+    summary: string;
+    emojiIcon?: string;
+    routine?: boolean;
+    rewardPoints?: number;
+}
+/**
+ * Create a task box item
+ * Task box items are unscheduled tasks that can later be assigned to specific dates
+ */
+export declare function createTaskBoxItem(options: CreateTaskBoxItemOptions): Promise<TaskBoxItemResource>;
+/**
+ * List the task box.
+ *
+ * Shape captured from the web app: GET /task_box/items returns template items
+ * (summary, emoji_icon, routine, reward_points). They carry no assignee and no
+ * date: the task box is a library of reusable chores, not scheduled work.
+ */
+export declare function listTaskBoxItems(): Promise<TaskBoxItemResource[]>;
+//# sourceMappingURL=taskbox.d.ts.map

package/dist/api/endpoints/taskbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskbox.d.ts","sourceRoot":"","sources":["../../../src/api/endpoints/taskbox.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,mBAAmB,EAEpB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,mBAAmB,CAAC,CAqB9B;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CASvE"}

package/dist/api/endpoints/taskbox.js

@@ -0,0 +1,39 @@
+import { getClient } from "../client.js";
+/**
+ * Create a task box item
+ * Task box items are unscheduled tasks that can later be assigned to specific dates
+ */
+export async function createTaskBoxItem(options) {
+    const client = getClient();
+    const request = {
+        data: {
+            type: "task_box_item",
+            attributes: {
+                summary: options.summary,
+                emoji_icon: options.emojiIcon ?? null,
+                routine: options.routine ?? false,
+                reward_points: options.rewardPoints ?? null,
+            },
+        },
+    };
+    const response = await client.post("/api/frames/{frameId}/task_box/items", request);
+    return response.data;
+}
+/**
+ * List the task box.
+ *
+ * Shape captured from the web app: GET /task_box/items returns template items
+ * (summary, emoji_icon, routine, reward_points). They carry no assignee and no
+ * date: the task box is a library of reusable chores, not scheduled work.
+ */
+export async function listTaskBoxItems() {
+    const client = getClient();
+    const response = await client.get("/api/frames/{frameId}/task_box/items");
+    if (!Array.isArray(response.data)) {
+        // Never report "empty" for a shape we don't recognise. Keys only: values could be personal.
+        const keys = response && typeof response === "object" ? Object.keys(response).join(", ") : typeof response;
+        throw new Error(`Unexpected task box response (top-level keys: ${keys || "none"})`);
+    }
+    return response.data;
+}
+//# sourceMappingURL=taskbox.js.map

package/dist/api/endpoints/taskbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskbox.js","sourceRoot":"","sources":["../../../src/api/endpoints/taskbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAezC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAiC;IAEjC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,MAAM,OAAO,GAA6B;QACxC,IAAI,EAAE;YACJ,IAAI,EAAE,eAAe;YACrB,UAAU,EAAE;gBACV,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;gBACrC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;gBACjC,aAAa,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;aAC5C;SACF;KACF,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,sCAAsC,EACtC,OAAO,CACR,CAAC;IAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAuB,sCAAsC,CAAC,CAAC;IAChG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,4FAA4F;QAC5F,MAAM,IAAI,GAAG,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC;QAC3G,MAAM,IAAI,KAAK,CAAC,iDAAiD,IAAI,IAAI,MAAM,GAAG,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC"}

package/dist/api/oauth.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Browser-paste OAuth login and token refresh.
+ *
+ * The user signs in to Skylight in their own browser, then pastes the final
+ * https://ourskylight.com/welcome?code=... URL back into the CLI. The password
+ * never reaches this process. The authorization code is bound to a PKCE
+ * verifier and a random state value that are kept in a short-lived, 0600
+ * "pending login" file between the two CLI steps.
+ *
+ * Design informed by kamilio/skylight-calendar-agent (MIT); see
+ * THIRD_PARTY_NOTICES.md. Unlike that project's flow, this one uses PKCE (S256)
+ * and verifies the returned state against the pending login.
+ */
+export declare const OAUTH_CLIENT_ID = "skylight-mobile";
+/** How long a pending login stays valid between `auth login` and `auth complete`. */
+export declare const PENDING_LOGIN_TTL_MS: number;
+/** Refresh this long before the access token actually expires. */
+export declare const EXPIRY_SKEW_MS: number;
+export interface StoredCredential {
+    version: 1;
+    type: "oauth";
+    accessToken: string;
+    refreshToken: string;
+    /** Stable per-install device id; sent with every token request. */
+    fingerprint: string;
+    /** Epoch milliseconds. */
+    expiresAt: number;
+}
+export interface PendingLogin {
+    state: string;
+    codeVerifier: string;
+    fingerprint: string;
+    createdAt: number;
+}
+export declare class OAuthError extends Error {
+    constructor(message: string);
+}
+type FetchLike = typeof fetch;
+/** The S256 challenge for a verifier. */
+export declare function codeChallengeFor(codeVerifier: string): string;
+/** Fresh PKCE verifier, state and device fingerprint for a new login. */
+export declare function newPendingLogin(now?: number, overrides?: Partial<Pick<PendingLogin, "state" | "fingerprint">>): PendingLogin;
+/** The Skylight authorize URL for a pending login. */
+export declare function authorizeUrlFor(pending: PendingLogin): string;
+/**
+ * Start a login: returns the URL the user must open in their browser and the
+ * pending-login record the caller must persist until `completeBrowserLogin`.
+ */
+export declare function beginBrowserLogin(now?: number, overrides?: Partial<Pick<PendingLogin, "state" | "fingerprint">>): {
+    loginUrl: string;
+    pending: PendingLogin;
+};
+/** Extract and validate the authorization code from the pasted callback URL. */
+export declare function parseCallbackUrl(callbackUrl: string, pending: PendingLogin, now?: number): string;
+/** Exchange the pasted callback URL for a credential. */
+export declare function completeBrowserLogin(callbackUrl: string, pending: PendingLogin, fetchImpl?: FetchLike, now?: number): Promise<StoredCredential>;
+/** Use the refresh token to obtain a new credential. Refresh tokens rotate. */
+export declare function refreshCredential(credential: StoredCredential, fetchImpl?: FetchLike, now?: number): Promise<StoredCredential>;
+export declare function isExpired(credential: StoredCredential, now?: number): boolean;
+export declare function parseStoredCredential(value: unknown): StoredCredential | null;
+export {};
+//# sourceMappingURL=oauth.d.ts.map

package/dist/api/oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../src/api/oauth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,eAAO,MAAM,eAAe,oBAAoB,CAAC;AAOjD,qFAAqF;AACrF,eAAO,MAAM,oBAAoB,QAAiB,CAAC;AAEnD,kEAAkE;AAClE,eAAO,MAAM,cAAc,QAAY,CAAC;AAExC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI5B;AAED,KAAK,SAAS,GAAG,OAAO,KAAK,CAAC;AAyB9B,yCAAyC;AACzC,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAmB,EAAE,SAAS,GAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,aAAa,CAAC,CAAM,GAAG,YAAY,CAO5I;AAED,sDAAsD;AACtD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAW7D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,GAAE,MAAmB,EACxB,SAAS,GAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,aAAa,CAAC,CAAM,GACnE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAG7C;AAQD,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAkC7G;AAsDD,yDAAyD;AACzD,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,YAAY,EACrB,SAAS,GAAE,SAAiB,EAC5B,GAAG,GAAE,MAAmB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAgB3B;AAED,+EAA+E;AAC/E,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,gBAAgB,EAC5B,SAAS,GAAE,SAAiB,EAC5B,GAAG,GAAE,MAAmB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAY3B;AAED,wBAAgB,SAAS,CAAC,UAAU,EAAE,gBAAgB,EAAE,GAAG,GAAE,MAAmB,GAAG,OAAO,CAEzF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAe7E"}