@particle-academy/gmail-inbox-js 0.0.0 → 0.1.0

package/dist/index.cjs

@@ -0,0 +1,341 @@
+'use strict';
+
+var fancyConnectorCore = require('@particle-academy/fancy-connector-core');
+
+// src/faker.ts
+function fakeLabelList({ config, fake }) {
+  return {
+    "labels": [
+      {
+        "id": "INBOX",
+        "name": "INBOX",
+        "type": "system"
+      },
+      {
+        "id": "UNREAD",
+        "name": "UNREAD",
+        "type": "system"
+      },
+      {
+        "id": "IMPORTANT",
+        "name": "IMPORTANT",
+        "type": "system",
+        "messagesTotal": 412,
+        "messagesUnread": 18,
+        "threadsTotal": 203,
+        "threadsUnread": 11
+      },
+      {
+        "id": fake.id("Label"),
+        "name": "Design Reviews",
+        "type": "user",
+        "messageListVisibility": "show",
+        "labelListVisibility": "labelShow",
+        "messagesTotal": 27,
+        "messagesUnread": 2,
+        "threadsTotal": 9,
+        "threadsUnread": 1
+      }
+    ]
+  };
+}
+function fakeMessageGet({ config, fake }) {
+  return {
+    "id": config.id !== void 0 && config.id !== null && config.id !== "" ? String(config.id) : fake.hex(16),
+    "threadId": fake.hex(16),
+    "labelIds": [
+      "INBOX",
+      "UNREAD",
+      "IMPORTANT"
+    ],
+    "snippet": "Hi Ada, just confirming the design review is still on for Thursday at 2pm. Let me know if...",
+    "internalDate": "1790712000000",
+    "payload": {
+      "mimeType": "text/plain",
+      "headers": [
+        {
+          "name": "From",
+          "value": "Grace Hopper <grace@example.test>"
+        },
+        {
+          "name": "To",
+          "value": "Ada Lovelace <ada@example.test>"
+        },
+        {
+          "name": "Subject",
+          "value": "Re: Design review Thursday"
+        },
+        {
+          "name": "Date",
+          "value": "Tue, 29 Sep 2026 14:03:00 -0400"
+        }
+      ],
+      "body": {
+        "size": 612,
+        "data": fake.id("base64url_body")
+      }
+    }
+  };
+}
+function fakeMessageList({ config, fake }) {
+  return {
+    "messages": [
+      {
+        "id": fake.hex(16),
+        "threadId": fake.hex(16)
+      },
+      {
+        "id": fake.hex(16),
+        "threadId": fake.hex(16)
+      }
+    ],
+    "resultSizeEstimate": 2
+  };
+}
+function fakeThreadGet({ config, fake }) {
+  return {
+    "id": config.id !== void 0 && config.id !== null && config.id !== "" ? String(config.id) : fake.hex(16),
+    "historyId": Array.from({ length: 10 }, () => fake.int(0, 9)).join(""),
+    "messages": [
+      {
+        "id": fake.hex(16),
+        "labelIds": [
+          "INBOX",
+          "IMPORTANT"
+        ],
+        "snippet": "Hey team, scheduling the Q3 design review for Thursday at 2pm. Conference room B...",
+        "internalDate": "1790625600000",
+        "payload": {
+          "mimeType": "text/plain",
+          "headers": [
+            {
+              "name": "From",
+              "value": "Ada Lovelace <ada@example.test>"
+            },
+            {
+              "name": "To",
+              "value": "Grace Hopper <grace@example.test>"
+            },
+            {
+              "name": "Subject",
+              "value": "Design review Thursday"
+            },
+            {
+              "name": "Date",
+              "value": "Mon, 28 Sep 2026 09:00:00 -0400"
+            }
+          ],
+          "body": {
+            "size": 540,
+            "data": fake.id("base64url_body")
+          }
+        }
+      },
+      {
+        "id": fake.hex(16),
+        "labelIds": [
+          "INBOX",
+          "UNREAD",
+          "IMPORTANT"
+        ],
+        "snippet": "Hi Ada, just confirming the design review is still on for Thursday at 2pm. Let me know if...",
+        "internalDate": "1790712000000",
+        "payload": {
+          "mimeType": "text/plain",
+          "headers": [
+            {
+              "name": "From",
+              "value": "Grace Hopper <grace@example.test>"
+            },
+            {
+              "name": "To",
+              "value": "Ada Lovelace <ada@example.test>"
+            },
+            {
+              "name": "Subject",
+              "value": "Re: Design review Thursday"
+            },
+            {
+              "name": "Date",
+              "value": "Tue, 29 Sep 2026 14:03:00 -0400"
+            }
+          ],
+          "body": {
+            "size": 612,
+            "data": fake.id("base64url_body")
+          }
+        }
+      }
+    ]
+  };
+}
+var gmailInboxFaker = (operation, request) => {
+  switch (operation) {
+    case "label_list":
+      return fakeLabelList(request);
+    case "message_get":
+      return fakeMessageGet(request);
+    case "message_list":
+      return fakeMessageList(request);
+    case "thread_get":
+      return fakeThreadGet(request);
+    default:
+      throw new Error(
+        `gmail_inbox: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
+      );
+  }
+};
+
+// src/service.ts
+var CONNECTOR_API_VERSION = 1;
+var GMAIL_INBOX_BASE_URLS = {
+  "live": "https://gmail.googleapis.com"
+};
+var GMAIL_INBOX_REQUIRES = [
+  "accessToken",
+  "refreshToken",
+  "clientId",
+  "clientSecret"
+];
+function gmailInboxAuthorize(credentials, request, _mode) {
+  request.headers.Authorization = `Bearer ${credentials.accessToken ?? ""}`;
+}
+var GMAIL_INBOX = {
+  service: "gmail_inbox",
+  title: "Gmail Inbox",
+  sandbox: "none",
+  baseUrls: { ...GMAIL_INBOX_BASE_URLS },
+  requires: [...GMAIL_INBOX_REQUIRES],
+  authorize: gmailInboxAuthorize,
+  faker: gmailInboxFaker
+};
+var LABEL_LIST_OPERATION = "label_list";
+async function gmailInboxLabelList(options) {
+  const config = options.config ?? {};
+  if (config.userId === void 0 || config.userId === null || config.userId === "") {
+    throw new Error(`label_list: "userId" is required (Mailbox).`);
+  }
+  return fancyConnectorCore.callConnector(GMAIL_INBOX, {
+    operation: LABEL_LIST_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "GET",
+      path: `/gmail/v1/users/${encodeURIComponent(String(config.userId))}/labels`,
+      query: {}
+    }
+  });
+}
+var MESSAGE_GET_OPERATION = "message_get";
+async function gmailInboxMessageGet(options) {
+  const config = options.config ?? {};
+  if (config.userId === void 0 || config.userId === null || config.userId === "") {
+    throw new Error(`message_get: "userId" is required (Mailbox).`);
+  }
+  if (config.id === void 0 || config.id === null || config.id === "") {
+    throw new Error(`message_get: "id" is required (Message ID).`);
+  }
+  return fancyConnectorCore.callConnector(GMAIL_INBOX, {
+    operation: MESSAGE_GET_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "GET",
+      path: `/gmail/v1/users/${encodeURIComponent(String(config.userId))}/messages/${encodeURIComponent(String(config.id))}`,
+      query: {
+        "format": "full"
+      }
+    }
+  });
+}
+var MESSAGE_LIST_OPERATION = "message_list";
+async function gmailInboxMessageList(options) {
+  const config = options.config ?? {};
+  if (config.userId === void 0 || config.userId === null || config.userId === "") {
+    throw new Error(`message_list: "userId" is required (Mailbox).`);
+  }
+  {
+    const n = Number(config.maxResults);
+    const given = config.maxResults !== void 0 && config.maxResults !== null && config.maxResults !== "";
+    if (given && !(Number.isInteger(n) && n >= 1 && n <= 500)) {
+      throw new Error(
+        `message_list: "maxResults" must be a integer, got ${JSON.stringify(config.maxResults)}.`
+      );
+    }
+  }
+  return fancyConnectorCore.callConnector(GMAIL_INBOX, {
+    operation: MESSAGE_LIST_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "GET",
+      path: `/gmail/v1/users/${encodeURIComponent(String(config.userId))}/messages`,
+      query: {
+        ...config.q !== void 0 && config.q !== null && config.q !== "" ? { "q": String(config.q) } : {},
+        ...config.labelId !== void 0 && config.labelId !== null && config.labelId !== "" ? { "labelIds": String(config.labelId) } : {},
+        ...config.includeSpamTrash !== void 0 && config.includeSpamTrash !== null && config.includeSpamTrash !== "" ? { "includeSpamTrash": Boolean(config.includeSpamTrash) } : {},
+        "maxResults": config.maxResults !== void 0 && config.maxResults !== null && config.maxResults !== "" ? Math.trunc(Number(config.maxResults)) : 100,
+        ...config.pageToken !== void 0 && config.pageToken !== null && config.pageToken !== "" ? { "pageToken": String(config.pageToken) } : {}
+      }
+    }
+  });
+}
+var THREAD_GET_OPERATION = "thread_get";
+async function gmailInboxThreadGet(options) {
+  const config = options.config ?? {};
+  if (config.userId === void 0 || config.userId === null || config.userId === "") {
+    throw new Error(`thread_get: "userId" is required (Mailbox).`);
+  }
+  if (config.id === void 0 || config.id === null || config.id === "") {
+    throw new Error(`thread_get: "id" is required (Thread ID).`);
+  }
+  return fancyConnectorCore.callConnector(GMAIL_INBOX, {
+    operation: THREAD_GET_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "GET",
+      path: `/gmail/v1/users/${encodeURIComponent(String(config.userId))}/threads/${encodeURIComponent(String(config.id))}`,
+      query: {
+        "format": "full"
+      }
+    }
+  });
+}
+
+exports.CONNECTOR_API_VERSION = CONNECTOR_API_VERSION;
+exports.GMAIL_INBOX = GMAIL_INBOX;
+exports.GMAIL_INBOX_BASE_URLS = GMAIL_INBOX_BASE_URLS;
+exports.GMAIL_INBOX_REQUIRES = GMAIL_INBOX_REQUIRES;
+exports.LABEL_LIST_OPERATION = LABEL_LIST_OPERATION;
+exports.MESSAGE_GET_OPERATION = MESSAGE_GET_OPERATION;
+exports.MESSAGE_LIST_OPERATION = MESSAGE_LIST_OPERATION;
+exports.THREAD_GET_OPERATION = THREAD_GET_OPERATION;
+exports.gmailInboxAuthorize = gmailInboxAuthorize;
+exports.gmailInboxFaker = gmailInboxFaker;
+exports.gmailInboxLabelList = gmailInboxLabelList;
+exports.gmailInboxMessageGet = gmailInboxMessageGet;
+exports.gmailInboxMessageList = gmailInboxMessageList;
+exports.gmailInboxThreadGet = gmailInboxThreadGet;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/label-list.ts","../src/actions/message-get.ts","../src/actions/message-list.ts","../src/actions/thread-get.ts"],"names":["callConnector"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- gmail_inbox\n */\n\n/**\n * The Gmail Inbox faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Gmail Inbox actually publishes, so an author can wire {{ $json.data.id\n * }} against a fake and have it keep working against the real thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeLabelList({ config, fake }: FakeRequest): unknown {\n  return {\n    \"labels\": [\n      {\n        \"id\": \"INBOX\",\n        \"name\": \"INBOX\",\n        \"type\": \"system\",\n      },\n      {\n        \"id\": \"UNREAD\",\n        \"name\": \"UNREAD\",\n        \"type\": \"system\",\n      },\n      {\n        \"id\": \"IMPORTANT\",\n        \"name\": \"IMPORTANT\",\n        \"type\": \"system\",\n        \"messagesTotal\": 412,\n        \"messagesUnread\": 18,\n        \"threadsTotal\": 203,\n        \"threadsUnread\": 11,\n      },\n      {\n        \"id\": fake.id(\"Label\"),\n        \"name\": \"Design Reviews\",\n        \"type\": \"user\",\n        \"messageListVisibility\": \"show\",\n        \"labelListVisibility\": \"labelShow\",\n        \"messagesTotal\": 27,\n        \"messagesUnread\": 2,\n        \"threadsTotal\": 9,\n        \"threadsUnread\": 1,\n      },\n    ],\n  };\n}\n\nfunction fakeMessageGet({ config, fake }: FakeRequest): unknown {\n  return {\n    \"id\": (config.id !== undefined && config.id !== null && config.id !== \"\" ? String(config.id) : fake.hex(16)),\n    \"threadId\": fake.hex(16),\n    \"labelIds\": [\n      \"INBOX\",\n      \"UNREAD\",\n      \"IMPORTANT\",\n    ],\n    \"snippet\": \"Hi Ada, just confirming the design review is still on for Thursday at 2pm. Let me know if...\",\n    \"internalDate\": \"1790712000000\",\n    \"payload\": {\n      \"mimeType\": \"text/plain\",\n      \"headers\": [\n        {\n          \"name\": \"From\",\n          \"value\": \"Grace Hopper <grace@example.test>\",\n        },\n        {\n          \"name\": \"To\",\n          \"value\": \"Ada Lovelace <ada@example.test>\",\n        },\n        {\n          \"name\": \"Subject\",\n          \"value\": \"Re: Design review Thursday\",\n        },\n        {\n          \"name\": \"Date\",\n          \"value\": \"Tue, 29 Sep 2026 14:03:00 -0400\",\n        },\n      ],\n      \"body\": {\n        \"size\": 612,\n        \"data\": fake.id(\"base64url_body\"),\n      },\n    },\n  };\n}\n\nfunction fakeMessageList({ config, fake }: FakeRequest): unknown {\n  return {\n    \"messages\": [\n      {\n        \"id\": fake.hex(16),\n        \"threadId\": fake.hex(16),\n      },\n      {\n        \"id\": fake.hex(16),\n        \"threadId\": fake.hex(16),\n      },\n    ],\n    \"resultSizeEstimate\": 2,\n  };\n}\n\nfunction fakeThreadGet({ config, fake }: FakeRequest): unknown {\n  return {\n    \"id\": (config.id !== undefined && config.id !== null && config.id !== \"\" ? String(config.id) : fake.hex(16)),\n    \"historyId\": Array.from({ length: 10 }, () => fake.int(0, 9)).join(\"\"),\n    \"messages\": [\n      {\n        \"id\": fake.hex(16),\n        \"labelIds\": [\n          \"INBOX\",\n          \"IMPORTANT\",\n        ],\n        \"snippet\": \"Hey team, scheduling the Q3 design review for Thursday at 2pm. Conference room B...\",\n        \"internalDate\": \"1790625600000\",\n        \"payload\": {\n          \"mimeType\": \"text/plain\",\n          \"headers\": [\n            {\n              \"name\": \"From\",\n              \"value\": \"Ada Lovelace <ada@example.test>\",\n            },\n            {\n              \"name\": \"To\",\n              \"value\": \"Grace Hopper <grace@example.test>\",\n            },\n            {\n              \"name\": \"Subject\",\n              \"value\": \"Design review Thursday\",\n            },\n            {\n              \"name\": \"Date\",\n              \"value\": \"Mon, 28 Sep 2026 09:00:00 -0400\",\n            },\n          ],\n          \"body\": {\n            \"size\": 540,\n            \"data\": fake.id(\"base64url_body\"),\n          },\n        },\n      },\n      {\n        \"id\": fake.hex(16),\n        \"labelIds\": [\n          \"INBOX\",\n          \"UNREAD\",\n          \"IMPORTANT\",\n        ],\n        \"snippet\": \"Hi Ada, just confirming the design review is still on for Thursday at 2pm. Let me know if...\",\n        \"internalDate\": \"1790712000000\",\n        \"payload\": {\n          \"mimeType\": \"text/plain\",\n          \"headers\": [\n            {\n              \"name\": \"From\",\n              \"value\": \"Grace Hopper <grace@example.test>\",\n            },\n            {\n              \"name\": \"To\",\n              \"value\": \"Ada Lovelace <ada@example.test>\",\n            },\n            {\n              \"name\": \"Subject\",\n              \"value\": \"Re: Design review Thursday\",\n            },\n            {\n              \"name\": \"Date\",\n              \"value\": \"Tue, 29 Sep 2026 14:03:00 -0400\",\n            },\n          ],\n          \"body\": {\n            \"size\": 612,\n            \"data\": fake.id(\"base64url_body\"),\n          },\n        },\n      },\n    ],\n  };\n}\n\nexport const gmailInboxFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"label_list\":\n      return fakeLabelList(request);\n\n    case \"message_get\":\n      return fakeMessageGet(request);\n\n    case \"message_list\":\n      return fakeMessageList(request);\n\n    case \"thread_get\":\n      return fakeThreadGet(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `gmail_inbox: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- gmail_inbox\n */\n\n/**\n * Gmail Inbox, as one service descriptor shared by every Gmail Inbox\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Gmail Inbox: its base URL, its auth\n * scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Gmail has no sandbox. Every read reaches the connected account's real mail.\n * The faker is the only way to develop against it without touching a real\n * mailbox.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { gmailInboxFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GMAIL_INBOX_BASE_URLS = {\n  \"live\": \"https://gmail.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GMAIL_INBOX_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Gmail Inbox's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function gmailInboxAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Gmail Inbox service, for the TypeScript runtime. */\nexport const GMAIL_INBOX: ServiceDescriptor = {\n  service: \"gmail_inbox\",\n  title: \"Gmail Inbox\",\n  sandbox: \"none\",\n  baseUrls: { ...GMAIL_INBOX_BASE_URLS },\n  requires: [...GMAIL_INBOX_REQUIRES],\n  authorize: gmailInboxAuthorize,\n  faker: gmailInboxFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/label-list.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/label-list.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- gmail_inbox\n */\n\n/**\n * List every label on the mailbox, system and user-created.\n *\n * GET /gmail/v1/users/{userId}/labels —\n * https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.labels/list\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Gmail Inbox or calls the\n * faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GMAIL_INBOX } from \"../service.js\";\n\nexport const LABEL_LIST_OPERATION = \"label_list\";\n\nexport type LabelListOptions = {\n  /** The node's resolved config. Keys: userId. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function gmailInboxLabelList(options: LabelListOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.userId === undefined || config.userId === null || config.userId === \"\") {\n    throw new Error(`label_list: \"userId\" is required (Mailbox).`);\n  }\n\n  return callConnector(GMAIL_INBOX, {\n    operation: LABEL_LIST_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"GET\",\n      path: `/gmail/v1/users/${encodeURIComponent(String(config.userId))}/labels`,\n      query: {},\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/message-get.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/message-get.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- gmail_inbox\n */\n\n/**\n * Read one message's headers and preview. The body's plain/HTML text is NOT\n * decoded -- see the raw payload for that.\n *\n * GET /gmail/v1/users/{userId}/messages/{id} —\n * https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/get\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Gmail Inbox or calls the\n * faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GMAIL_INBOX } from \"../service.js\";\n\nexport const MESSAGE_GET_OPERATION = \"message_get\";\n\nexport type MessageGetOptions = {\n  /** The node's resolved config. Keys: userId, id. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function gmailInboxMessageGet(options: MessageGetOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.userId === undefined || config.userId === null || config.userId === \"\") {\n    throw new Error(`message_get: \"userId\" is required (Mailbox).`);\n  }\n\n  if (config.id === undefined || config.id === null || config.id === \"\") {\n    throw new Error(`message_get: \"id\" is required (Message ID).`);\n  }\n\n  return callConnector(GMAIL_INBOX, {\n    operation: MESSAGE_GET_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"GET\",\n      path: `/gmail/v1/users/${encodeURIComponent(String(config.userId))}/messages/${encodeURIComponent(String(config.id))}`,\n      query: {\n        \"format\": \"full\",\n      },\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/message-list.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/message-list.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- gmail_inbox\n */\n\n/**\n * List message ids matching a search, newest first.\n *\n * GET /gmail/v1/users/{userId}/messages —\n * https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/list\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Gmail Inbox or calls the\n * faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GMAIL_INBOX } from \"../service.js\";\n\nexport const MESSAGE_LIST_OPERATION = \"message_list\";\n\nexport type MessageListOptions = {\n  /** The node's resolved config. Keys: userId, q, labelId, includeSpamTrash, maxResults, pageToken. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function gmailInboxMessageList(options: MessageListOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.userId === undefined || config.userId === null || config.userId === \"\") {\n    throw new Error(`message_list: \"userId\" is required (Mailbox).`);\n  }\n\n  {\n    const n = Number(config.maxResults);\n    const given = config.maxResults !== undefined && config.maxResults !== null && config.maxResults !== \"\";\n    if (given && !(Number.isInteger(n) && n >= 1 && n <= 500)) {\n      throw new Error(\n        `message_list: \"maxResults\" must be a integer, got ${JSON.stringify(config.maxResults)}.`,\n      );\n    }\n  }\n\n  return callConnector(GMAIL_INBOX, {\n    operation: MESSAGE_LIST_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"GET\",\n      path: `/gmail/v1/users/${encodeURIComponent(String(config.userId))}/messages`,\n      query: {\n        ...(config.q !== undefined && config.q !== null && config.q !== \"\" ? { \"q\": String(config.q) } : {}),\n        ...(config.labelId !== undefined && config.labelId !== null && config.labelId !== \"\" ? { \"labelIds\": String(config.labelId) } : {}),\n        ...(config.includeSpamTrash !== undefined && config.includeSpamTrash !== null && config.includeSpamTrash !== \"\" ? { \"includeSpamTrash\": Boolean(config.includeSpamTrash) } : {}),\n        \"maxResults\": config.maxResults !== undefined && config.maxResults !== null && config.maxResults !== \"\" ? Math.trunc(Number(config.maxResults)) : 100,\n        ...(config.pageToken !== undefined && config.pageToken !== null && config.pageToken !== \"\" ? { \"pageToken\": String(config.pageToken) } : {}),\n      },\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/thread-get.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/thread-get.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- gmail_inbox\n */\n\n/**\n * Read every message in a conversation thread, oldest first.\n *\n * GET /gmail/v1/users/{userId}/threads/{id} —\n * https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.threads/get\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Gmail Inbox or calls the\n * faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GMAIL_INBOX } from \"../service.js\";\n\nexport const THREAD_GET_OPERATION = \"thread_get\";\n\nexport type ThreadGetOptions = {\n  /** The node's resolved config. Keys: userId, id. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function gmailInboxThreadGet(options: ThreadGetOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.userId === undefined || config.userId === null || config.userId === \"\") {\n    throw new Error(`thread_get: \"userId\" is required (Mailbox).`);\n  }\n\n  if (config.id === undefined || config.id === null || config.id === \"\") {\n    throw new Error(`thread_get: \"id\" is required (Thread ID).`);\n  }\n\n  return callConnector(GMAIL_INBOX, {\n    operation: THREAD_GET_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"GET\",\n      path: `/gmail/v1/users/${encodeURIComponent(String(config.userId))}/threads/${encodeURIComponent(String(config.id))}`,\n      query: {\n        \"format\": \"full\",\n      },\n    },\n  });\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,223 @@
+import { ServiceDescriptor, PreparedRequest, ConnectorMode, ConnectorFaker, RequestedMode, Transport, ConnectorResult } from '@particle-academy/fancy-connector-core';
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/manifest.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/manifest.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- gmail_inbox
+ */
+/**
+ * Gmail Inbox, as one service descriptor shared by every Gmail Inbox
+ * operation.
+ *
+ * @particle-academy/fancy-connector-core carries what is true of ALL
+ * connectors. This carries what is true of Gmail Inbox: its base URL, its auth
+ * scheme, its idempotency header, and its faker.
+ *
+ * ## The sandbox trap, written down where it is used
+ *
+ * Gmail has no sandbox. Every read reaches the connected account's real mail.
+ * The faker is the only way to develop against it without touching a real
+ * mailbox.
+ */
+
+/**
+ * The connector API version this package was GENERATED against.
+ *
+ * A literal, never imported. An imported constant lets an upgrade rewrite the
+ * very claim it exists to detect, after which the copy agrees with itself
+ * forever.
+ */
+declare const CONNECTOR_API_VERSION = 1;
+declare const GMAIL_INBOX_BASE_URLS: {
+    readonly live: "https://gmail.googleapis.com";
+};
+/** Credential keys a remote call cannot proceed without. */
+declare const GMAIL_INBOX_REQUIRES: readonly ["accessToken", "refreshToken", "clientId", "clientSecret"];
+/**
+ * Apply Gmail Inbox's auth scheme to an outgoing request.
+ *
+ *
+ *
+ * The mode is passed in because for some providers auth and estate are the
+ * same decision expressed in the URL; here it is unused, and saying so is
+ * cheaper than wondering later whether it was forgotten.
+ */
+declare function gmailInboxAuthorize(credentials: Record<string, string | undefined>, request: PreparedRequest, _mode: ConnectorMode): void;
+/** The Gmail Inbox service, for the TypeScript runtime. */
+declare const GMAIL_INBOX: ServiceDescriptor;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/fixtures/ by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/fixtures/ (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- gmail_inbox
+ */
+/**
+ * The Gmail Inbox faker.
+ *
+ * Shapes, not behaviour: the goal is that a downstream node sees the field
+ * NAMES Gmail Inbox actually publishes, so an author can wire {{ $json.data.id
+ * }} against a fake and have it keep working against the real thing.
+ *
+ * Deterministic — same inputs, same output. A faker returning a fresh uuid
+ * every call cannot be asserted on, so its fixtures degrade to "it did not
+ * throw", which is the assertion that catches nothing.
+ */
+
+declare const gmailInboxFaker: ConnectorFaker;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/label-list.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/label-list.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- gmail_inbox
+ */
+/**
+ * List every label on the mailbox, system and user-created.
+ *
+ * GET /gmail/v1/users/{userId}/labels —
+ * https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.labels/list
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Gmail Inbox or calls the
+ * faker.
+ */
+
+declare const LABEL_LIST_OPERATION = "label_list";
+type LabelListOptions = {
+    /** The node's resolved config. Keys: userId. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function gmailInboxLabelList(options: LabelListOptions): Promise<ConnectorResult>;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/message-get.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/message-get.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- gmail_inbox
+ */
+/**
+ * Read one message's headers and preview. The body's plain/HTML text is NOT
+ * decoded -- see the raw payload for that.
+ *
+ * GET /gmail/v1/users/{userId}/messages/{id} —
+ * https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/get
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Gmail Inbox or calls the
+ * faker.
+ */
+
+declare const MESSAGE_GET_OPERATION = "message_get";
+type MessageGetOptions = {
+    /** The node's resolved config. Keys: userId, id. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function gmailInboxMessageGet(options: MessageGetOptions): Promise<ConnectorResult>;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/message-list.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/message-list.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- gmail_inbox
+ */
+/**
+ * List message ids matching a search, newest first.
+ *
+ * GET /gmail/v1/users/{userId}/messages —
+ * https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/list
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Gmail Inbox or calls the
+ * faker.
+ */
+
+declare const MESSAGE_LIST_OPERATION = "message_list";
+type MessageListOptions = {
+    /** The node's resolved config. Keys: userId, q, labelId, includeSpamTrash, maxResults, pageToken. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function gmailInboxMessageList(options: MessageListOptions): Promise<ConnectorResult>;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/thread-get.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/thread-get.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- gmail_inbox
+ */
+/**
+ * Read every message in a conversation thread, oldest first.
+ *
+ * GET /gmail/v1/users/{userId}/threads/{id} —
+ * https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.threads/get
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Gmail Inbox or calls the
+ * faker.
+ */
+
+declare const THREAD_GET_OPERATION = "thread_get";
+type ThreadGetOptions = {
+    /** The node's resolved config. Keys: userId, id. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function gmailInboxThreadGet(options: ThreadGetOptions): Promise<ConnectorResult>;
+
+export { CONNECTOR_API_VERSION, GMAIL_INBOX, GMAIL_INBOX_BASE_URLS, GMAIL_INBOX_REQUIRES, LABEL_LIST_OPERATION, type LabelListOptions, MESSAGE_GET_OPERATION, MESSAGE_LIST_OPERATION, type MessageGetOptions, type MessageListOptions, THREAD_GET_OPERATION, type ThreadGetOptions, gmailInboxAuthorize, gmailInboxFaker, gmailInboxLabelList, gmailInboxMessageGet, gmailInboxMessageList, gmailInboxThreadGet };