@kb-labs/inbox-entry 2.96.0

package/dist/rest/handlers/search-handler.js

@@ -0,0 +1,92 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { resolveAccount, searchMessages, InboxError } from '@kb-labs/inbox-core';
+
+// src/rest/handlers/search-handler.ts
+var REST_STATUS = {
+  ENV_MISSING: 400,
+  ACCOUNT_NOT_FOUND: 400,
+  IMAP_AUTH_FAILED: 401,
+  IMAP_CONNECT_FAILED: 503,
+  IMAP_TIMEOUT: 504,
+  IMAP_MAILBOX_NOT_FOUND: 404,
+  MESSAGE_NOT_FOUND: 404,
+  SMTP_AUTH_FAILED: 401,
+  SMTP_CONNECT_FAILED: 503,
+  SMTP_INVALID_RECIPIENT: 400,
+  VALIDATION_ERROR: 400,
+  INTERNAL_ERROR: 500
+};
+function getHint(code, message) {
+  switch (code) {
+    case "ENV_MISSING":
+      return "Set INBOX_ACCOUNTS=work,personal and account vars (INBOX_ACCOUNT_WORK_USER, _PASS, _IMAP_HOST, _SMTP_HOST)";
+    case "ACCOUNT_NOT_FOUND":
+      return `Use kb inbox accounts to see configured accounts, then pass the name with --account`;
+    case "IMAP_AUTH_FAILED":
+      return "Create an app-password in Yandex ID settings (yandex.ru/id) and set it as INBOX_ACCOUNT_<NAME>_PASS";
+    case "IMAP_CONNECT_FAILED":
+      return `Check INBOX_ACCOUNT_<NAME>_IMAP_HOST and _IMAP_PORT, and that the server is reachable`;
+    case "IMAP_TIMEOUT":
+      return "Server did not respond in time \u2014 try again in a moment";
+    case "IMAP_MAILBOX_NOT_FOUND":
+      return "Run kb inbox folders --account <name> to see available folders";
+    case "MESSAGE_NOT_FOUND":
+      return "The uid may be stale \u2014 refresh with: kb inbox list";
+    case "SMTP_AUTH_FAILED":
+      return "Create an app-password in Yandex ID settings and set it as INBOX_ACCOUNT_<NAME>_PASS";
+    case "SMTP_CONNECT_FAILED":
+      return "Check INBOX_ACCOUNT_<NAME>_SMTP_HOST and _SMTP_PORT";
+    case "SMTP_INVALID_RECIPIENT":
+      return "Verify the --to address is a valid email";
+    case "VALIDATION_ERROR":
+      return void 0;
+    // message itself is descriptive enough
+    case "INTERNAL_ERROR":
+      return void 0;
+    default: {
+      return void 0;
+    }
+  }
+}
+function rethrowForRest(err) {
+  if (err instanceof InboxError) {
+    const hint = getHint(err.code, err.message);
+    throw Object.assign(new Error(err.message), {
+      statusCode: REST_STATUS[err.code] ?? 500,
+      code: err.code,
+      details: hint ? { hint } : void 0
+    });
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  throw Object.assign(new Error(message), {
+    statusCode: 500,
+    code: "INTERNAL_ERROR"
+  });
+}
+
+// src/rest/handlers/search-handler.ts
+var search_handler_default = defineHandler({
+  async execute(_ctx, input) {
+    try {
+      const q = input.query ?? {};
+      const account = resolveAccount(q.account);
+      const since = q.since ? new Date(q.since) : void 0;
+      const messages = await searchMessages(account, {
+        from: q.from,
+        subject: q.subject,
+        body: q.body,
+        text: q.text,
+        folder: q.folder,
+        since,
+        limit: q.limit ? parseInt(q.limit, 10) : 20
+      });
+      return { ok: true, result: messages };
+    } catch (err) {
+      rethrowForRest(err);
+    }
+  }
+});
+
+export { search_handler_default as default };
+//# sourceMappingURL=search-handler.js.map
+//# sourceMappingURL=search-handler.js.map

package/dist/rest/handlers/search-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/error.ts","../../../src/rest/handlers/search-handler.ts"],"names":[],"mappings":"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","file":"search-handler.js","sourcesContent":["import type { PluginContextV3 } from '@kb-labs/sdk';\nimport { InboxError, type InboxErrorCode } from '@kb-labs/inbox-core';\n\n// HTTP status codes for REST layer\nconst REST_STATUS: Record<InboxErrorCode, number> = {\n  ENV_MISSING:            400,\n  ACCOUNT_NOT_FOUND:      400,\n  IMAP_AUTH_FAILED:       401,\n  IMAP_CONNECT_FAILED:    503,\n  IMAP_TIMEOUT:           504,\n  IMAP_MAILBOX_NOT_FOUND: 404,\n  MESSAGE_NOT_FOUND:      404,\n  SMTP_AUTH_FAILED:       401,\n  SMTP_CONNECT_FAILED:    503,\n  SMTP_INVALID_RECIPIENT: 400,\n  VALIDATION_ERROR:       400,\n  INTERNAL_ERROR:         500,\n};\n\n// Human-readable hints per error code\nfunction getHint(code: InboxErrorCode, message: string): string | undefined {\n  switch (code) {\n    case 'ENV_MISSING':\n      return 'Set INBOX_ACCOUNTS=work,personal and account vars (INBOX_ACCOUNT_WORK_USER, _PASS, _IMAP_HOST, _SMTP_HOST)';\n    case 'ACCOUNT_NOT_FOUND':\n      return `Use kb inbox accounts to see configured accounts, then pass the name with --account`;\n    case 'IMAP_AUTH_FAILED':\n      return 'Create an app-password in Yandex ID settings (yandex.ru/id) and set it as INBOX_ACCOUNT_<NAME>_PASS';\n    case 'IMAP_CONNECT_FAILED':\n      return `Check INBOX_ACCOUNT_<NAME>_IMAP_HOST and _IMAP_PORT, and that the server is reachable`;\n    case 'IMAP_TIMEOUT':\n      return 'Server did not respond in time — try again in a moment';\n    case 'IMAP_MAILBOX_NOT_FOUND':\n      return 'Run kb inbox folders --account <name> to see available folders';\n    case 'MESSAGE_NOT_FOUND':\n      return 'The uid may be stale — refresh with: kb inbox list';\n    case 'SMTP_AUTH_FAILED':\n      return 'Create an app-password in Yandex ID settings and set it as INBOX_ACCOUNT_<NAME>_PASS';\n    case 'SMTP_CONNECT_FAILED':\n      return 'Check INBOX_ACCOUNT_<NAME>_SMTP_HOST and _SMTP_PORT';\n    case 'SMTP_INVALID_RECIPIENT':\n      return 'Verify the --to address is a valid email';\n    case 'VALIDATION_ERROR':\n      return undefined; // message itself is descriptive enough\n    case 'INTERNAL_ERROR':\n      return undefined;\n    default: {\n      const _: never = code;\n      void _;\n      return undefined;\n    }\n  }\n}\n\n/**\n * Output a structured error for CLI commands.\n *\n * JSON mode  → { ok: false, error: { code, message, hint? } }  — agent-parseable\n * Human mode → ctx.ui.error() with hint and cause fields\n *\n * Call right before `return { exitCode: 1, result: null }`.\n */\nexport function handleError(ctx: PluginContextV3, err: unknown, isJson?: boolean): void {\n  if (err instanceof InboxError) {\n    const hint = getHint(err.code, err.message);\n\n    if (isJson) {\n      ctx.ui?.json?.({\n        ok: false,\n        error: {\n          code: err.code,\n          message: err.message,\n          ...(hint && { hint }),\n        },\n      });\n    } else {\n      ctx.ui?.error?.(err.message, {\n        ...(hint && { hint }),\n        cause: `InboxError [${err.code}]`,\n      });\n    }\n    return;\n  }\n\n  // Unknown error\n  const message = err instanceof Error ? err.message : String(err);\n\n  if (isJson) {\n    ctx.ui?.json?.({\n      ok: false,\n      error: { code: 'INTERNAL_ERROR', message },\n    });\n  } else {\n    ctx.ui?.error?.(message);\n  }\n}\n\n/**\n * Re-throws err as an HTTP-aware error for REST handlers.\n * InboxError → preserves HTTP status; others → 500.\n */\nexport function rethrowForRest(err: unknown): never {\n  if (err instanceof InboxError) {\n    const hint = getHint(err.code, err.message);\n    throw Object.assign(new Error(err.message), {\n      statusCode: REST_STATUS[err.code] ?? 500,\n      code: err.code,\n      details: hint ? { hint } : undefined,\n    });\n  }\n\n  const message = err instanceof Error ? err.message : String(err);\n  throw Object.assign(new Error(message), {\n    statusCode: 500,\n    code: 'INTERNAL_ERROR',\n  });\n}\n","import { defineHandler, type PluginContextV3, type RestInput } from '@kb-labs/sdk';\nimport { resolveAccount, searchMessages } from '@kb-labs/inbox-core';\nimport { rethrowForRest } from '../../utils/error.js';\n\ntype Query = { from?: string; subject?: string; body?: string; text?: string; folder?: string; since?: string; limit?: string; account?: string };\n\nexport default defineHandler({\n  async execute(_ctx: PluginContextV3, input: RestInput<Query, never, never>) {\n    try {\n      const q = input.query ?? {};\n      const account = resolveAccount(q.account);\n      const since = q.since ? new Date(q.since) : undefined;\n\n      const messages = await searchMessages(account, {\n        from: q.from,\n        subject: q.subject,\n        body: q.body,\n        text: q.text,\n        folder: q.folder,\n        since,\n        limit: q.limit ? parseInt(q.limit, 10) : 20,\n      });\n\n      return { ok: true, result: messages };\n    } catch (err) {\n      rethrowForRest(err);\n    }\n  },\n});\n"]}

package/dist/rest/handlers/send-handler.d.ts

@@ -0,0 +1,18 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<never, {
+    to: string;
+    subject: string;
+    body: string;
+    cc?: string | undefined;
+    bcc?: string | undefined;
+    account?: string | undefined;
+}, never>, {
+    ok: boolean;
+    result: {
+        messageId: string;
+    };
+}>;
+
+export { _default as default };

package/dist/rest/handlers/send-handler.js

@@ -0,0 +1,89 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { resolveAccount, sendMessage, InboxError } from '@kb-labs/inbox-core';
+
+// src/rest/handlers/send-handler.ts
+var REST_STATUS = {
+  ENV_MISSING: 400,
+  ACCOUNT_NOT_FOUND: 400,
+  IMAP_AUTH_FAILED: 401,
+  IMAP_CONNECT_FAILED: 503,
+  IMAP_TIMEOUT: 504,
+  IMAP_MAILBOX_NOT_FOUND: 404,
+  MESSAGE_NOT_FOUND: 404,
+  SMTP_AUTH_FAILED: 401,
+  SMTP_CONNECT_FAILED: 503,
+  SMTP_INVALID_RECIPIENT: 400,
+  VALIDATION_ERROR: 400,
+  INTERNAL_ERROR: 500
+};
+function getHint(code, message) {
+  switch (code) {
+    case "ENV_MISSING":
+      return "Set INBOX_ACCOUNTS=work,personal and account vars (INBOX_ACCOUNT_WORK_USER, _PASS, _IMAP_HOST, _SMTP_HOST)";
+    case "ACCOUNT_NOT_FOUND":
+      return `Use kb inbox accounts to see configured accounts, then pass the name with --account`;
+    case "IMAP_AUTH_FAILED":
+      return "Create an app-password in Yandex ID settings (yandex.ru/id) and set it as INBOX_ACCOUNT_<NAME>_PASS";
+    case "IMAP_CONNECT_FAILED":
+      return `Check INBOX_ACCOUNT_<NAME>_IMAP_HOST and _IMAP_PORT, and that the server is reachable`;
+    case "IMAP_TIMEOUT":
+      return "Server did not respond in time \u2014 try again in a moment";
+    case "IMAP_MAILBOX_NOT_FOUND":
+      return "Run kb inbox folders --account <name> to see available folders";
+    case "MESSAGE_NOT_FOUND":
+      return "The uid may be stale \u2014 refresh with: kb inbox list";
+    case "SMTP_AUTH_FAILED":
+      return "Create an app-password in Yandex ID settings and set it as INBOX_ACCOUNT_<NAME>_PASS";
+    case "SMTP_CONNECT_FAILED":
+      return "Check INBOX_ACCOUNT_<NAME>_SMTP_HOST and _SMTP_PORT";
+    case "SMTP_INVALID_RECIPIENT":
+      return "Verify the --to address is a valid email";
+    case "VALIDATION_ERROR":
+      return void 0;
+    // message itself is descriptive enough
+    case "INTERNAL_ERROR":
+      return void 0;
+    default: {
+      return void 0;
+    }
+  }
+}
+function rethrowForRest(err) {
+  if (err instanceof InboxError) {
+    const hint = getHint(err.code, err.message);
+    throw Object.assign(new Error(err.message), {
+      statusCode: REST_STATUS[err.code] ?? 500,
+      code: err.code,
+      details: hint ? { hint } : void 0
+    });
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  throw Object.assign(new Error(message), {
+    statusCode: 500,
+    code: "INTERNAL_ERROR"
+  });
+}
+
+// src/rest/handlers/send-handler.ts
+var send_handler_default = defineHandler({
+  async execute(_ctx, input) {
+    try {
+      const body = input.body;
+      const account = resolveAccount(body.account);
+      const result = await sendMessage(account, {
+        to: body.to,
+        subject: body.subject,
+        body: body.body,
+        cc: body.cc,
+        bcc: body.bcc
+      });
+      return { ok: true, result };
+    } catch (err) {
+      rethrowForRest(err);
+    }
+  }
+});
+
+export { send_handler_default as default };
+//# sourceMappingURL=send-handler.js.map
+//# sourceMappingURL=send-handler.js.map

package/dist/rest/handlers/send-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/error.ts","../../../src/rest/handlers/send-handler.ts"],"names":[],"mappings":"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","file":"send-handler.js","sourcesContent":["import type { PluginContextV3 } from '@kb-labs/sdk';\nimport { InboxError, type InboxErrorCode } from '@kb-labs/inbox-core';\n\n// HTTP status codes for REST layer\nconst REST_STATUS: Record<InboxErrorCode, number> = {\n  ENV_MISSING:            400,\n  ACCOUNT_NOT_FOUND:      400,\n  IMAP_AUTH_FAILED:       401,\n  IMAP_CONNECT_FAILED:    503,\n  IMAP_TIMEOUT:           504,\n  IMAP_MAILBOX_NOT_FOUND: 404,\n  MESSAGE_NOT_FOUND:      404,\n  SMTP_AUTH_FAILED:       401,\n  SMTP_CONNECT_FAILED:    503,\n  SMTP_INVALID_RECIPIENT: 400,\n  VALIDATION_ERROR:       400,\n  INTERNAL_ERROR:         500,\n};\n\n// Human-readable hints per error code\nfunction getHint(code: InboxErrorCode, message: string): string | undefined {\n  switch (code) {\n    case 'ENV_MISSING':\n      return 'Set INBOX_ACCOUNTS=work,personal and account vars (INBOX_ACCOUNT_WORK_USER, _PASS, _IMAP_HOST, _SMTP_HOST)';\n    case 'ACCOUNT_NOT_FOUND':\n      return `Use kb inbox accounts to see configured accounts, then pass the name with --account`;\n    case 'IMAP_AUTH_FAILED':\n      return 'Create an app-password in Yandex ID settings (yandex.ru/id) and set it as INBOX_ACCOUNT_<NAME>_PASS';\n    case 'IMAP_CONNECT_FAILED':\n      return `Check INBOX_ACCOUNT_<NAME>_IMAP_HOST and _IMAP_PORT, and that the server is reachable`;\n    case 'IMAP_TIMEOUT':\n      return 'Server did not respond in time — try again in a moment';\n    case 'IMAP_MAILBOX_NOT_FOUND':\n      return 'Run kb inbox folders --account <name> to see available folders';\n    case 'MESSAGE_NOT_FOUND':\n      return 'The uid may be stale — refresh with: kb inbox list';\n    case 'SMTP_AUTH_FAILED':\n      return 'Create an app-password in Yandex ID settings and set it as INBOX_ACCOUNT_<NAME>_PASS';\n    case 'SMTP_CONNECT_FAILED':\n      return 'Check INBOX_ACCOUNT_<NAME>_SMTP_HOST and _SMTP_PORT';\n    case 'SMTP_INVALID_RECIPIENT':\n      return 'Verify the --to address is a valid email';\n    case 'VALIDATION_ERROR':\n      return undefined; // message itself is descriptive enough\n    case 'INTERNAL_ERROR':\n      return undefined;\n    default: {\n      const _: never = code;\n      void _;\n      return undefined;\n    }\n  }\n}\n\n/**\n * Output a structured error for CLI commands.\n *\n * JSON mode  → { ok: false, error: { code, message, hint? } }  — agent-parseable\n * Human mode → ctx.ui.error() with hint and cause fields\n *\n * Call right before `return { exitCode: 1, result: null }`.\n */\nexport function handleError(ctx: PluginContextV3, err: unknown, isJson?: boolean): void {\n  if (err instanceof InboxError) {\n    const hint = getHint(err.code, err.message);\n\n    if (isJson) {\n      ctx.ui?.json?.({\n        ok: false,\n        error: {\n          code: err.code,\n          message: err.message,\n          ...(hint && { hint }),\n        },\n      });\n    } else {\n      ctx.ui?.error?.(err.message, {\n        ...(hint && { hint }),\n        cause: `InboxError [${err.code}]`,\n      });\n    }\n    return;\n  }\n\n  // Unknown error\n  const message = err instanceof Error ? err.message : String(err);\n\n  if (isJson) {\n    ctx.ui?.json?.({\n      ok: false,\n      error: { code: 'INTERNAL_ERROR', message },\n    });\n  } else {\n    ctx.ui?.error?.(message);\n  }\n}\n\n/**\n * Re-throws err as an HTTP-aware error for REST handlers.\n * InboxError → preserves HTTP status; others → 500.\n */\nexport function rethrowForRest(err: unknown): never {\n  if (err instanceof InboxError) {\n    const hint = getHint(err.code, err.message);\n    throw Object.assign(new Error(err.message), {\n      statusCode: REST_STATUS[err.code] ?? 500,\n      code: err.code,\n      details: hint ? { hint } : undefined,\n    });\n  }\n\n  const message = err instanceof Error ? err.message : String(err);\n  throw Object.assign(new Error(message), {\n    statusCode: 500,\n    code: 'INTERNAL_ERROR',\n  });\n}\n","import { defineHandler, type PluginContextV3, type RestInput } from '@kb-labs/sdk';\nimport { resolveAccount, sendMessage } from '@kb-labs/inbox-core';\nimport type { SendMessageInput } from '@kb-labs/inbox-contracts';\nimport { rethrowForRest } from '../../utils/error.js';\n\nexport default defineHandler({\n  async execute(_ctx: PluginContextV3, input: RestInput<never, SendMessageInput, never>) {\n    try {\n      const body = input.body!;\n      const account = resolveAccount(body.account);\n      const result = await sendMessage(account, {\n        to: body.to,\n        subject: body.subject,\n        body: body.body,\n        cc: body.cc,\n        bcc: body.bcc,\n      });\n\n      return { ok: true, result };\n    } catch (err) {\n      rethrowForRest(err);\n    }\n  },\n});\n"]}

package/dist/rest/handlers/thread-handler.d.ts

@@ -0,0 +1,17 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import * as _kb_labs_inbox_contracts from '@kb-labs/inbox-contracts';
+import { RestInput } from '@kb-labs/sdk';
+
+type Query = {
+    folder?: string;
+    account?: string;
+};
+type Params = {
+    uid: string;
+};
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<Query, never, Params>, {
+    ok: boolean;
+    result: _kb_labs_inbox_contracts.Email[];
+}>;
+
+export { _default as default };

package/dist/rest/handlers/thread-handler.js

@@ -0,0 +1,87 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { resolveAccount, getThread, InboxError } from '@kb-labs/inbox-core';
+
+// src/rest/handlers/thread-handler.ts
+var REST_STATUS = {
+  ENV_MISSING: 400,
+  ACCOUNT_NOT_FOUND: 400,
+  IMAP_AUTH_FAILED: 401,
+  IMAP_CONNECT_FAILED: 503,
+  IMAP_TIMEOUT: 504,
+  IMAP_MAILBOX_NOT_FOUND: 404,
+  MESSAGE_NOT_FOUND: 404,
+  SMTP_AUTH_FAILED: 401,
+  SMTP_CONNECT_FAILED: 503,
+  SMTP_INVALID_RECIPIENT: 400,
+  VALIDATION_ERROR: 400,
+  INTERNAL_ERROR: 500
+};
+function getHint(code, message) {
+  switch (code) {
+    case "ENV_MISSING":
+      return "Set INBOX_ACCOUNTS=work,personal and account vars (INBOX_ACCOUNT_WORK_USER, _PASS, _IMAP_HOST, _SMTP_HOST)";
+    case "ACCOUNT_NOT_FOUND":
+      return `Use kb inbox accounts to see configured accounts, then pass the name with --account`;
+    case "IMAP_AUTH_FAILED":
+      return "Create an app-password in Yandex ID settings (yandex.ru/id) and set it as INBOX_ACCOUNT_<NAME>_PASS";
+    case "IMAP_CONNECT_FAILED":
+      return `Check INBOX_ACCOUNT_<NAME>_IMAP_HOST and _IMAP_PORT, and that the server is reachable`;
+    case "IMAP_TIMEOUT":
+      return "Server did not respond in time \u2014 try again in a moment";
+    case "IMAP_MAILBOX_NOT_FOUND":
+      return "Run kb inbox folders --account <name> to see available folders";
+    case "MESSAGE_NOT_FOUND":
+      return "The uid may be stale \u2014 refresh with: kb inbox list";
+    case "SMTP_AUTH_FAILED":
+      return "Create an app-password in Yandex ID settings and set it as INBOX_ACCOUNT_<NAME>_PASS";
+    case "SMTP_CONNECT_FAILED":
+      return "Check INBOX_ACCOUNT_<NAME>_SMTP_HOST and _SMTP_PORT";
+    case "SMTP_INVALID_RECIPIENT":
+      return "Verify the --to address is a valid email";
+    case "VALIDATION_ERROR":
+      return void 0;
+    // message itself is descriptive enough
+    case "INTERNAL_ERROR":
+      return void 0;
+    default: {
+      return void 0;
+    }
+  }
+}
+function rethrowForRest(err) {
+  if (err instanceof InboxError) {
+    const hint = getHint(err.code, err.message);
+    throw Object.assign(new Error(err.message), {
+      statusCode: REST_STATUS[err.code] ?? 500,
+      code: err.code,
+      details: hint ? { hint } : void 0
+    });
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  throw Object.assign(new Error(message), {
+    statusCode: 500,
+    code: "INTERNAL_ERROR"
+  });
+}
+
+// src/rest/handlers/thread-handler.ts
+var thread_handler_default = defineHandler({
+  async execute(_ctx, input) {
+    try {
+      const uid = parseInt(input.params?.uid ?? "", 10);
+      if (isNaN(uid)) {
+        throw Object.assign(new Error("uid must be a number"), { statusCode: 400, code: "VALIDATION_ERROR" });
+      }
+      const q = input.query ?? {};
+      const account = resolveAccount(q.account);
+      const thread = await getThread(account, uid, { folder: q.folder ?? "INBOX" });
+      return { ok: true, result: thread };
+    } catch (err) {
+      rethrowForRest(err);
+    }
+  }
+});
+
+export { thread_handler_default as default };
+//# sourceMappingURL=thread-handler.js.map
+//# sourceMappingURL=thread-handler.js.map

package/dist/rest/handlers/thread-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/error.ts","../../../src/rest/handlers/thread-handler.ts"],"names":[],"mappings":"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","file":"thread-handler.js","sourcesContent":["import type { PluginContextV3 } from '@kb-labs/sdk';\nimport { InboxError, type InboxErrorCode } from '@kb-labs/inbox-core';\n\n// HTTP status codes for REST layer\nconst REST_STATUS: Record<InboxErrorCode, number> = {\n  ENV_MISSING:            400,\n  ACCOUNT_NOT_FOUND:      400,\n  IMAP_AUTH_FAILED:       401,\n  IMAP_CONNECT_FAILED:    503,\n  IMAP_TIMEOUT:           504,\n  IMAP_MAILBOX_NOT_FOUND: 404,\n  MESSAGE_NOT_FOUND:      404,\n  SMTP_AUTH_FAILED:       401,\n  SMTP_CONNECT_FAILED:    503,\n  SMTP_INVALID_RECIPIENT: 400,\n  VALIDATION_ERROR:       400,\n  INTERNAL_ERROR:         500,\n};\n\n// Human-readable hints per error code\nfunction getHint(code: InboxErrorCode, message: string): string | undefined {\n  switch (code) {\n    case 'ENV_MISSING':\n      return 'Set INBOX_ACCOUNTS=work,personal and account vars (INBOX_ACCOUNT_WORK_USER, _PASS, _IMAP_HOST, _SMTP_HOST)';\n    case 'ACCOUNT_NOT_FOUND':\n      return `Use kb inbox accounts to see configured accounts, then pass the name with --account`;\n    case 'IMAP_AUTH_FAILED':\n      return 'Create an app-password in Yandex ID settings (yandex.ru/id) and set it as INBOX_ACCOUNT_<NAME>_PASS';\n    case 'IMAP_CONNECT_FAILED':\n      return `Check INBOX_ACCOUNT_<NAME>_IMAP_HOST and _IMAP_PORT, and that the server is reachable`;\n    case 'IMAP_TIMEOUT':\n      return 'Server did not respond in time — try again in a moment';\n    case 'IMAP_MAILBOX_NOT_FOUND':\n      return 'Run kb inbox folders --account <name> to see available folders';\n    case 'MESSAGE_NOT_FOUND':\n      return 'The uid may be stale — refresh with: kb inbox list';\n    case 'SMTP_AUTH_FAILED':\n      return 'Create an app-password in Yandex ID settings and set it as INBOX_ACCOUNT_<NAME>_PASS';\n    case 'SMTP_CONNECT_FAILED':\n      return 'Check INBOX_ACCOUNT_<NAME>_SMTP_HOST and _SMTP_PORT';\n    case 'SMTP_INVALID_RECIPIENT':\n      return 'Verify the --to address is a valid email';\n    case 'VALIDATION_ERROR':\n      return undefined; // message itself is descriptive enough\n    case 'INTERNAL_ERROR':\n      return undefined;\n    default: {\n      const _: never = code;\n      void _;\n      return undefined;\n    }\n  }\n}\n\n/**\n * Output a structured error for CLI commands.\n *\n * JSON mode  → { ok: false, error: { code, message, hint? } }  — agent-parseable\n * Human mode → ctx.ui.error() with hint and cause fields\n *\n * Call right before `return { exitCode: 1, result: null }`.\n */\nexport function handleError(ctx: PluginContextV3, err: unknown, isJson?: boolean): void {\n  if (err instanceof InboxError) {\n    const hint = getHint(err.code, err.message);\n\n    if (isJson) {\n      ctx.ui?.json?.({\n        ok: false,\n        error: {\n          code: err.code,\n          message: err.message,\n          ...(hint && { hint }),\n        },\n      });\n    } else {\n      ctx.ui?.error?.(err.message, {\n        ...(hint && { hint }),\n        cause: `InboxError [${err.code}]`,\n      });\n    }\n    return;\n  }\n\n  // Unknown error\n  const message = err instanceof Error ? err.message : String(err);\n\n  if (isJson) {\n    ctx.ui?.json?.({\n      ok: false,\n      error: { code: 'INTERNAL_ERROR', message },\n    });\n  } else {\n    ctx.ui?.error?.(message);\n  }\n}\n\n/**\n * Re-throws err as an HTTP-aware error for REST handlers.\n * InboxError → preserves HTTP status; others → 500.\n */\nexport function rethrowForRest(err: unknown): never {\n  if (err instanceof InboxError) {\n    const hint = getHint(err.code, err.message);\n    throw Object.assign(new Error(err.message), {\n      statusCode: REST_STATUS[err.code] ?? 500,\n      code: err.code,\n      details: hint ? { hint } : undefined,\n    });\n  }\n\n  const message = err instanceof Error ? err.message : String(err);\n  throw Object.assign(new Error(message), {\n    statusCode: 500,\n    code: 'INTERNAL_ERROR',\n  });\n}\n","import { defineHandler, type PluginContextV3, type RestInput } from '@kb-labs/sdk';\nimport { resolveAccount, getThread } from '@kb-labs/inbox-core';\nimport { rethrowForRest } from '../../utils/error.js';\n\ntype Query = { folder?: string; account?: string };\ntype Params = { uid: string };\n\nexport default defineHandler({\n  async execute(_ctx: PluginContextV3, input: RestInput<Query, never, Params>) {\n    try {\n      const uid = parseInt(input.params?.uid ?? '', 10);\n      if (isNaN(uid)) { throw Object.assign(new Error('uid must be a number'), { statusCode: 400, code: 'VALIDATION_ERROR' }); }\n\n      const q = input.query ?? {};\n      const account = resolveAccount(q.account);\n      const thread = await getThread(account, uid, { folder: q.folder ?? 'INBOX' });\n\n      return { ok: true, result: thread };\n    } catch (err) {\n      rethrowForRest(err);\n    }\n  },\n});\n"]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@kb-labs/inbox-entry",
+  "version": "2.96.0",
+  "type": "module",
+  "description": "V3 manifest + CLI commands + REST handlers for inbox plugin",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./plugin-manifest": {
+      "import": "./dist/manifest.js",
+      "types": "./dist/manifest.d.ts"
+    }
+  },
+  "kb": {
+    "manifest": "./dist/manifest.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@kb-labs/sdk": "2.21.2",
+    "@kb-labs/shared-command-kit": "2.96.0",
+    "@kb-labs/inbox-core": "2.96.0",
+    "@kb-labs/inbox-contracts": "2.96.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.6",
+    "@kb-labs/shared-testing-e2e": "2.96.0",
+    "@kb-labs/devkit": "2.96.0"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:cli": "vitest run --config vitest.cli.config.ts --passWithNoTests"
+  }
+}