@bmhall2/skylight-mcp 1.1.7

package/dist/utils/errors.js

@@ -0,0 +1,102 @@
+/**
+ * Base error class for Skylight API errors
+ */
+export class SkylightError extends Error {
+    code;
+    statusCode;
+    recoverable;
+    constructor(message, code, statusCode, recoverable = false) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.recoverable = recoverable;
+        this.name = "SkylightError";
+    }
+}
+/**
+ * Authentication failed - token may be expired or invalid
+ */
+export class AuthenticationError extends SkylightError {
+    constructor(message = "Authentication failed. Your token may be expired or invalid.") {
+        super(message, "AUTH_FAILED", 401, true);
+        this.name = "AuthenticationError";
+    }
+}
+/**
+ * Configuration error - missing or invalid settings
+ */
+export class ConfigurationError extends SkylightError {
+    constructor(message) {
+        super(message, "CONFIG_ERROR", undefined, true);
+        this.name = "ConfigurationError";
+    }
+}
+/**
+ * Resource not found
+ */
+export class NotFoundError extends SkylightError {
+    constructor(resource) {
+        super(`${resource} not found`, "NOT_FOUND", 404, false);
+        this.name = "NotFoundError";
+    }
+}
+/**
+ * Rate limited by the API
+ */
+export class RateLimitError extends SkylightError {
+    constructor(retryAfter) {
+        super(`Rate limited by Skylight API. ${retryAfter ? `Retry after ${retryAfter}s` : "Please wait and try again."}`, "RATE_LIMITED", 429, true);
+        this.name = "RateLimitError";
+    }
+}
+/**
+ * API returned an unexpected response format
+ */
+export class ParseError extends SkylightError {
+    constructor(message = "Unexpected API response format") {
+        super(message, "PARSE_ERROR", undefined, false);
+        this.name = "ParseError";
+    }
+}
+/**
+ * Format an error for MCP tool response
+ * Accepts unknown to handle any value from catch blocks safely
+ */
+export function formatErrorForMcp(error) {
+    if (error instanceof AuthenticationError) {
+        return `Authentication Error: ${error.message}
+
+Your Skylight token may have expired. To fix this:
+1. Open the Skylight app on your device
+2. Capture fresh API traffic using a proxy tool
+3. Update your SKYLIGHT_TOKEN environment variable
+
+See the auth documentation for detailed steps.`;
+    }
+    if (error instanceof NotFoundError) {
+        return `Not Found: ${error.message}
+
+This could mean:
+- The requested item doesn't exist
+- Your frame ID is incorrect
+- The item was deleted from Skylight`;
+    }
+    if (error instanceof RateLimitError) {
+        return `Rate Limited: ${error.message}
+
+The Skylight API is temporarily limiting requests. Please wait a moment and try again.`;
+    }
+    if (error instanceof ConfigurationError) {
+        return `Configuration Error: ${error.message}
+
+Please check your environment variables are set correctly.`;
+    }
+    if (error instanceof SkylightError) {
+        return `Skylight Error: ${error.message}`;
+    }
+    if (error instanceof Error) {
+        return `Error: ${error.message}`;
+    }
+    return `Error: ${String(error)}`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAG7B;IACA;IACA;IAJT,YACE,OAAe,EACR,IAAY,EACZ,UAAmB,EACnB,cAAuB,KAAK;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAS;QACnB,gBAAW,GAAX,WAAW,CAAiB;QAGnC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IACpD,YAAY,UAAkB,8DAA8D;QAC1F,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,aAAa;IAC9C,YAAY,QAAgB;QAC1B,KAAK,CAAC,GAAG,QAAQ,YAAY,EAAE,WAAW,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,aAAa;IAC/C,YAAY,UAAmB;QAC7B,KAAK,CACH,iCAAiC,UAAU,CAAC,CAAC,CAAC,eAAe,UAAU,GAAG,CAAC,CAAC,CAAC,4BAA4B,EAAE,EAC3G,cAAc,EACd,GAAG,EACH,IAAI,CACL,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,aAAa;IAC3C,YAAY,UAAkB,gCAAgC;QAC5D,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;QACzC,OAAO,yBAAyB,KAAK,CAAC,OAAO;;;;;;;+CAOF,CAAC;IAC9C,CAAC;IAED,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;QACnC,OAAO,cAAc,KAAK,CAAC,OAAO;;;;;qCAKD,CAAC;IACpC,CAAC;IAED,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,OAAO,iBAAiB,KAAK,CAAC,OAAO;;uFAE8C,CAAC;IACtF,CAAC;IAED,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;QACxC,OAAO,wBAAwB,KAAK,CAAC,OAAO;;2DAEW,CAAC;IAC1D,CAAC;IAED,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;QACnC,OAAO,mBAAmB,KAAK,CAAC,OAAO,EAAE,CAAC;IAC5C,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;IAED,OAAO,UAAU,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACnC,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@bmhall2/skylight-mcp",
+  "version": "1.1.7",
+  "description": "MCP server for Skylight Calendar API - enables agentic interactions for calendar, chores, lists, and family management",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "skylight-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "prepare": "npm run build",
+    "generate:types": "openapi-typescript ../skylight-api/docs/openapi/openapi.yaml -o src/api/generated-types.ts"
+  },
+  "keywords": [
+    "mcp",
+    "skylight",
+    "calendar",
+    "model-context-protocol",
+    "claude",
+    "ai",
+    "family",
+    "chores"
+  ],
+  "author": "Ben Hall <bmhall2@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bmhall2/skylight-mcp.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.12.2",
+    "typescript": "^5.4.5",
+    "tsx": "^4.7.0",
+    "vitest": "^1.6.0",
+    "eslint": "^8.57.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "openapi-typescript": "^7.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}