@particle-academy/gmail-inbox-ui 0.0.0-stage → 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,178 @@
+import * as _particle_academy_fancy_flow_connectors from '@particle-academy/fancy-flow/connectors';
+import { ConnectorMeta, OutputField } from '@particle-academy/fancy-flow/connectors';
+import { NodeKindDefinition } from '@particle-academy/fancy-flow/engine';
+
+/**
+ * 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's identity on the authoring surface, shared by every Gmail Inbox
+ * node.
+ *
+ * This file must import nothing from the js package: a PHP or Python project
+ * installs the ui package and never that one, and the import would be a
+ * dangling module the moment it did.
+ *
+ * ## The sandbox trap
+ *
+ * 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.
+ */
+declare const CONNECTOR_API_VERSION = 1;
+/** The parts of a connector's identity that belong to the SERVICE, not the node. */
+declare const GMAIL_INBOX_SERVICE: {
+    readonly service: "gmail_inbox";
+    readonly serviceTitle: "Gmail Inbox";
+    readonly domain: "email";
+    readonly sandbox: "none";
+};
+/** The credentials a Gmail Inbox connection holds. */
+declare const GMAIL_INBOX_CREDENTIALS: readonly [{
+    readonly key: "clientId";
+    readonly label: "OAuth client ID";
+    readonly scope: "provider";
+    readonly secret: false;
+    readonly help: "A DIFFERENT OAuth app than `gmail`'s, from Google Cloud Console -> APIs & Services -> Credentials. This one requests a restricted scope and carries Google's annual CASA assessment; `gmail`'s does not. Do not reuse the same client for both.";
+}, {
+    readonly key: "clientSecret";
+    readonly label: "OAuth client secret";
+    readonly scope: "provider";
+    readonly secret: true;
+    readonly help: "The client secret for the same OAuth app. One value for the whole installation.";
+}, {
+    readonly key: "accessToken";
+    readonly label: "Access token";
+    readonly scope: "account";
+    readonly secret: true;
+    readonly help: "Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token.";
+}, {
+    readonly key: "refreshToken";
+    readonly label: "Refresh token";
+    readonly scope: "account";
+    readonly secret: true;
+    readonly help: "Per connected Google account. Google issues one only when the consent request asks for offline access; without it the connection dies within the hour.";
+}];
+/**
+ * The OAuth2 exchange Gmail Inbox requires — DECLARED here, performed by the
+ * host.
+ *
+ * A consent screen needs a browser, a redirect URI and somewhere to persist
+ * the result, and all three belong to the host; a package that ran the dance
+ * itself would have to own a web server. So this says precisely enough for a
+ * host to do it.
+ *
+ * The access token lasts 3600 seconds. A host that never refreshes will work
+ * all afternoon and be broken by morning, which is why the lifetime is stated
+ * rather than left to be discovered.
+ *
+ * Its refresh tokens do NOT rotate: the same one is reusable, so a refresh may
+ * safely be retried and may run concurrently. That is stated rather than
+ * assumed because the opposite — a provider that spends the token and revokes
+ * the grant on a replay — looks identical until it happens.
+ */
+declare const GMAIL_INBOX_OAUTH: {
+    readonly flow: "authorization_code";
+    readonly authorizeUrl: "https://accounts.google.com/o/oauth2/v2/auth";
+    readonly tokenUrl: "https://oauth2.googleapis.com/token";
+    readonly scopes: readonly ["https://www.googleapis.com/auth/gmail.readonly"];
+    readonly accessTokenCredential: "accessToken";
+    readonly refreshTokenCredential: "refreshToken";
+    readonly refreshTokenRotates: false;
+    readonly accessTokenTtlSeconds: 3600;
+};
+/** Build a Gmail Inbox node's connector metadata from the operation it performs. */
+declare function gmailInboxMeta(role: ConnectorMeta["role"], operation: string, docs: string): ConnectorMeta;
+
+declare const GMAIL_INBOX_LABEL_LIST_KIND = "@particle-academy/gmail_inbox_label_list";
+declare const GMAIL_INBOX_LABEL_LIST_OPERATION = "label_list";
+declare const GMAIL_INBOX_LABEL_LIST_META: _particle_academy_fancy_flow_connectors.ConnectorMeta;
+/**
+ * What this node emits — the "ingredients" a downstream node can reference.
+ *
+ * fancy-flow reads `outputShape` off the kind and offers it in the variable
+ * picker, so declaring it is the whole of the work: an author configuring the
+ * next node picks `{{ $json.data.id }}` off a list instead of typing a path
+ * and hoping.
+ */
+declare const GMAIL_INBOX_LABEL_LIST_OUTPUT: OutputField[];
+declare const gmailInboxLabelListKind: NodeKindDefinition;
+
+declare const GMAIL_INBOX_MESSAGE_GET_KIND = "@particle-academy/gmail_inbox_message_get";
+declare const GMAIL_INBOX_MESSAGE_GET_OPERATION = "message_get";
+declare const GMAIL_INBOX_MESSAGE_GET_META: _particle_academy_fancy_flow_connectors.ConnectorMeta;
+/**
+ * What this node emits — the "ingredients" a downstream node can reference.
+ *
+ * fancy-flow reads `outputShape` off the kind and offers it in the variable
+ * picker, so declaring it is the whole of the work: an author configuring the
+ * next node picks `{{ $json.data.id }}` off a list instead of typing a path
+ * and hoping.
+ */
+declare const GMAIL_INBOX_MESSAGE_GET_OUTPUT: OutputField[];
+declare const gmailInboxMessageGetKind: NodeKindDefinition;
+
+declare const GMAIL_INBOX_MESSAGE_LIST_KIND = "@particle-academy/gmail_inbox_message_list";
+declare const GMAIL_INBOX_MESSAGE_LIST_OPERATION = "message_list";
+declare const GMAIL_INBOX_MESSAGE_LIST_META: _particle_academy_fancy_flow_connectors.ConnectorMeta;
+/**
+ * What this node emits — the "ingredients" a downstream node can reference.
+ *
+ * fancy-flow reads `outputShape` off the kind and offers it in the variable
+ * picker, so declaring it is the whole of the work: an author configuring the
+ * next node picks `{{ $json.data.id }}` off a list instead of typing a path
+ * and hoping.
+ */
+declare const GMAIL_INBOX_MESSAGE_LIST_OUTPUT: OutputField[];
+declare const gmailInboxMessageListKind: NodeKindDefinition;
+
+declare const GMAIL_INBOX_THREAD_GET_KIND = "@particle-academy/gmail_inbox_thread_get";
+declare const GMAIL_INBOX_THREAD_GET_OPERATION = "thread_get";
+declare const GMAIL_INBOX_THREAD_GET_META: _particle_academy_fancy_flow_connectors.ConnectorMeta;
+/**
+ * What this node emits — the "ingredients" a downstream node can reference.
+ *
+ * fancy-flow reads `outputShape` off the kind and offers it in the variable
+ * picker, so declaring it is the whole of the work: an author configuring the
+ * next node picks `{{ $json.data.id }}` off a list instead of typing a path
+ * and hoping.
+ */
+declare const GMAIL_INBOX_THREAD_GET_OUTPUT: OutputField[];
+declare const gmailInboxThreadGetKind: NodeKindDefinition;
+
+/**
+ * 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's node kinds for fancy-flow.
+ *
+ * Install this on every host. The TypeScript executors live in the js
+ * package's `./flow` subpath; PHP and Python hosts run their own and need only
+ * this.
+ */
+
+/** Every Gmail Inbox kind, for a host that registers the lot. */
+declare const GMAIL_INBOX_KINDS: NodeKindDefinition[];
+
+export { CONNECTOR_API_VERSION, GMAIL_INBOX_CREDENTIALS, GMAIL_INBOX_KINDS, GMAIL_INBOX_LABEL_LIST_KIND, GMAIL_INBOX_LABEL_LIST_META, GMAIL_INBOX_LABEL_LIST_OPERATION, GMAIL_INBOX_LABEL_LIST_OUTPUT, GMAIL_INBOX_MESSAGE_GET_KIND, GMAIL_INBOX_MESSAGE_GET_META, GMAIL_INBOX_MESSAGE_GET_OPERATION, GMAIL_INBOX_MESSAGE_GET_OUTPUT, GMAIL_INBOX_MESSAGE_LIST_KIND, GMAIL_INBOX_MESSAGE_LIST_META, GMAIL_INBOX_MESSAGE_LIST_OPERATION, GMAIL_INBOX_MESSAGE_LIST_OUTPUT, GMAIL_INBOX_OAUTH, GMAIL_INBOX_SERVICE, GMAIL_INBOX_THREAD_GET_KIND, GMAIL_INBOX_THREAD_GET_META, GMAIL_INBOX_THREAD_GET_OPERATION, GMAIL_INBOX_THREAD_GET_OUTPUT, gmailInboxLabelListKind, gmailInboxMessageGetKind, gmailInboxMessageListKind, gmailInboxMeta, gmailInboxThreadGetKind };

package/dist/index.d.ts

@@ -0,0 +1,178 @@
+import * as _particle_academy_fancy_flow_connectors from '@particle-academy/fancy-flow/connectors';
+import { ConnectorMeta, OutputField } from '@particle-academy/fancy-flow/connectors';
+import { NodeKindDefinition } from '@particle-academy/fancy-flow/engine';
+
+/**
+ * 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's identity on the authoring surface, shared by every Gmail Inbox
+ * node.
+ *
+ * This file must import nothing from the js package: a PHP or Python project
+ * installs the ui package and never that one, and the import would be a
+ * dangling module the moment it did.
+ *
+ * ## The sandbox trap
+ *
+ * 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.
+ */
+declare const CONNECTOR_API_VERSION = 1;
+/** The parts of a connector's identity that belong to the SERVICE, not the node. */
+declare const GMAIL_INBOX_SERVICE: {
+    readonly service: "gmail_inbox";
+    readonly serviceTitle: "Gmail Inbox";
+    readonly domain: "email";
+    readonly sandbox: "none";
+};
+/** The credentials a Gmail Inbox connection holds. */
+declare const GMAIL_INBOX_CREDENTIALS: readonly [{
+    readonly key: "clientId";
+    readonly label: "OAuth client ID";
+    readonly scope: "provider";
+    readonly secret: false;
+    readonly help: "A DIFFERENT OAuth app than `gmail`'s, from Google Cloud Console -> APIs & Services -> Credentials. This one requests a restricted scope and carries Google's annual CASA assessment; `gmail`'s does not. Do not reuse the same client for both.";
+}, {
+    readonly key: "clientSecret";
+    readonly label: "OAuth client secret";
+    readonly scope: "provider";
+    readonly secret: true;
+    readonly help: "The client secret for the same OAuth app. One value for the whole installation.";
+}, {
+    readonly key: "accessToken";
+    readonly label: "Access token";
+    readonly scope: "account";
+    readonly secret: true;
+    readonly help: "Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token.";
+}, {
+    readonly key: "refreshToken";
+    readonly label: "Refresh token";
+    readonly scope: "account";
+    readonly secret: true;
+    readonly help: "Per connected Google account. Google issues one only when the consent request asks for offline access; without it the connection dies within the hour.";
+}];
+/**
+ * The OAuth2 exchange Gmail Inbox requires — DECLARED here, performed by the
+ * host.
+ *
+ * A consent screen needs a browser, a redirect URI and somewhere to persist
+ * the result, and all three belong to the host; a package that ran the dance
+ * itself would have to own a web server. So this says precisely enough for a
+ * host to do it.
+ *
+ * The access token lasts 3600 seconds. A host that never refreshes will work
+ * all afternoon and be broken by morning, which is why the lifetime is stated
+ * rather than left to be discovered.
+ *
+ * Its refresh tokens do NOT rotate: the same one is reusable, so a refresh may
+ * safely be retried and may run concurrently. That is stated rather than
+ * assumed because the opposite — a provider that spends the token and revokes
+ * the grant on a replay — looks identical until it happens.
+ */
+declare const GMAIL_INBOX_OAUTH: {
+    readonly flow: "authorization_code";
+    readonly authorizeUrl: "https://accounts.google.com/o/oauth2/v2/auth";
+    readonly tokenUrl: "https://oauth2.googleapis.com/token";
+    readonly scopes: readonly ["https://www.googleapis.com/auth/gmail.readonly"];
+    readonly accessTokenCredential: "accessToken";
+    readonly refreshTokenCredential: "refreshToken";
+    readonly refreshTokenRotates: false;
+    readonly accessTokenTtlSeconds: 3600;
+};
+/** Build a Gmail Inbox node's connector metadata from the operation it performs. */
+declare function gmailInboxMeta(role: ConnectorMeta["role"], operation: string, docs: string): ConnectorMeta;
+
+declare const GMAIL_INBOX_LABEL_LIST_KIND = "@particle-academy/gmail_inbox_label_list";
+declare const GMAIL_INBOX_LABEL_LIST_OPERATION = "label_list";
+declare const GMAIL_INBOX_LABEL_LIST_META: _particle_academy_fancy_flow_connectors.ConnectorMeta;
+/**
+ * What this node emits — the "ingredients" a downstream node can reference.
+ *
+ * fancy-flow reads `outputShape` off the kind and offers it in the variable
+ * picker, so declaring it is the whole of the work: an author configuring the
+ * next node picks `{{ $json.data.id }}` off a list instead of typing a path
+ * and hoping.
+ */
+declare const GMAIL_INBOX_LABEL_LIST_OUTPUT: OutputField[];
+declare const gmailInboxLabelListKind: NodeKindDefinition;
+
+declare const GMAIL_INBOX_MESSAGE_GET_KIND = "@particle-academy/gmail_inbox_message_get";
+declare const GMAIL_INBOX_MESSAGE_GET_OPERATION = "message_get";
+declare const GMAIL_INBOX_MESSAGE_GET_META: _particle_academy_fancy_flow_connectors.ConnectorMeta;
+/**
+ * What this node emits — the "ingredients" a downstream node can reference.
+ *
+ * fancy-flow reads `outputShape` off the kind and offers it in the variable
+ * picker, so declaring it is the whole of the work: an author configuring the
+ * next node picks `{{ $json.data.id }}` off a list instead of typing a path
+ * and hoping.
+ */
+declare const GMAIL_INBOX_MESSAGE_GET_OUTPUT: OutputField[];
+declare const gmailInboxMessageGetKind: NodeKindDefinition;
+
+declare const GMAIL_INBOX_MESSAGE_LIST_KIND = "@particle-academy/gmail_inbox_message_list";
+declare const GMAIL_INBOX_MESSAGE_LIST_OPERATION = "message_list";
+declare const GMAIL_INBOX_MESSAGE_LIST_META: _particle_academy_fancy_flow_connectors.ConnectorMeta;
+/**
+ * What this node emits — the "ingredients" a downstream node can reference.
+ *
+ * fancy-flow reads `outputShape` off the kind and offers it in the variable
+ * picker, so declaring it is the whole of the work: an author configuring the
+ * next node picks `{{ $json.data.id }}` off a list instead of typing a path
+ * and hoping.
+ */
+declare const GMAIL_INBOX_MESSAGE_LIST_OUTPUT: OutputField[];
+declare const gmailInboxMessageListKind: NodeKindDefinition;
+
+declare const GMAIL_INBOX_THREAD_GET_KIND = "@particle-academy/gmail_inbox_thread_get";
+declare const GMAIL_INBOX_THREAD_GET_OPERATION = "thread_get";
+declare const GMAIL_INBOX_THREAD_GET_META: _particle_academy_fancy_flow_connectors.ConnectorMeta;
+/**
+ * What this node emits — the "ingredients" a downstream node can reference.
+ *
+ * fancy-flow reads `outputShape` off the kind and offers it in the variable
+ * picker, so declaring it is the whole of the work: an author configuring the
+ * next node picks `{{ $json.data.id }}` off a list instead of typing a path
+ * and hoping.
+ */
+declare const GMAIL_INBOX_THREAD_GET_OUTPUT: OutputField[];
+declare const gmailInboxThreadGetKind: NodeKindDefinition;
+
+/**
+ * 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's node kinds for fancy-flow.
+ *
+ * Install this on every host. The TypeScript executors live in the js
+ * package's `./flow` subpath; PHP and Python hosts run their own and need only
+ * this.
+ */
+
+/** Every Gmail Inbox kind, for a host that registers the lot. */
+declare const GMAIL_INBOX_KINDS: NodeKindDefinition[];
+
+export { CONNECTOR_API_VERSION, GMAIL_INBOX_CREDENTIALS, GMAIL_INBOX_KINDS, GMAIL_INBOX_LABEL_LIST_KIND, GMAIL_INBOX_LABEL_LIST_META, GMAIL_INBOX_LABEL_LIST_OPERATION, GMAIL_INBOX_LABEL_LIST_OUTPUT, GMAIL_INBOX_MESSAGE_GET_KIND, GMAIL_INBOX_MESSAGE_GET_META, GMAIL_INBOX_MESSAGE_GET_OPERATION, GMAIL_INBOX_MESSAGE_GET_OUTPUT, GMAIL_INBOX_MESSAGE_LIST_KIND, GMAIL_INBOX_MESSAGE_LIST_META, GMAIL_INBOX_MESSAGE_LIST_OPERATION, GMAIL_INBOX_MESSAGE_LIST_OUTPUT, GMAIL_INBOX_OAUTH, GMAIL_INBOX_SERVICE, GMAIL_INBOX_THREAD_GET_KIND, GMAIL_INBOX_THREAD_GET_META, GMAIL_INBOX_THREAD_GET_OPERATION, GMAIL_INBOX_THREAD_GET_OUTPUT, gmailInboxLabelListKind, gmailInboxMessageGetKind, gmailInboxMessageListKind, gmailInboxMeta, gmailInboxThreadGetKind };

package/dist/index.js

@@ -0,0 +1,312 @@
+import { defineConnectorKind, summarize } from '@particle-academy/fancy-flow/connectors';
+
+// src/service.ts
+var CONNECTOR_API_VERSION = 1;
+var GMAIL_INBOX_SERVICE = {
+  service: "gmail_inbox",
+  serviceTitle: "Gmail Inbox",
+  domain: "email",
+  sandbox: "none"
+};
+var GMAIL_INBOX_CREDENTIALS = [
+  {
+    "key": "clientId",
+    "label": "OAuth client ID",
+    "scope": "provider",
+    "secret": false,
+    "help": "A DIFFERENT OAuth app than `gmail`'s, from Google Cloud Console -> APIs & Services -> Credentials. This one requests a restricted scope and carries Google's annual CASA assessment; `gmail`'s does not. Do not reuse the same client for both."
+  },
+  {
+    "key": "clientSecret",
+    "label": "OAuth client secret",
+    "scope": "provider",
+    "secret": true,
+    "help": "The client secret for the same OAuth app. One value for the whole installation."
+  },
+  {
+    "key": "accessToken",
+    "label": "Access token",
+    "scope": "account",
+    "secret": true,
+    "help": "Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token."
+  },
+  {
+    "key": "refreshToken",
+    "label": "Refresh token",
+    "scope": "account",
+    "secret": true,
+    "help": "Per connected Google account. Google issues one only when the consent request asks for offline access; without it the connection dies within the hour."
+  }
+];
+var GMAIL_INBOX_OAUTH = {
+  "flow": "authorization_code",
+  "authorizeUrl": "https://accounts.google.com/o/oauth2/v2/auth",
+  "tokenUrl": "https://oauth2.googleapis.com/token",
+  "scopes": [
+    "https://www.googleapis.com/auth/gmail.readonly"
+  ],
+  "accessTokenCredential": "accessToken",
+  "refreshTokenCredential": "refreshToken",
+  "refreshTokenRotates": false,
+  "accessTokenTtlSeconds": 3600
+};
+function gmailInboxMeta(role, operation, docs) {
+  return { ...GMAIL_INBOX_SERVICE, role, operation, docs };
+}
+var GMAIL_INBOX_LABEL_LIST_KIND = "@particle-academy/gmail_inbox_label_list";
+var GMAIL_INBOX_LABEL_LIST_OPERATION = "label_list";
+var GMAIL_INBOX_LABEL_LIST_META = gmailInboxMeta("action", "list labels", "https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.labels/list");
+var GMAIL_INBOX_LABEL_LIST_OUTPUT = [
+  {
+    "path": "data.labels",
+    "type": "array",
+    "description": "Each with id, name and type (system or user). messagesTotal/messagesUnread/threadsTotal/threadsUnread are part of Label's schema but not confirmed present on every list row -- read one label with labels.get if a count comes back missing."
+  }
+];
+var gmailInboxLabelListKind = defineConnectorKind(GMAIL_INBOX_LABEL_LIST_META, {
+  name: GMAIL_INBOX_LABEL_LIST_KIND,
+  aliases: ["gmail_inbox_label_list"],
+  label: "List Gmail labels",
+  description: "List every label on the mailbox, system and user-created.",
+  inputs: [{ id: "in" }],
+  outputs: [{ id: "out" }],
+  sideEffects: "none",
+  outputShape: GMAIL_INBOX_LABEL_LIST_OUTPUT,
+  configSchema: [
+    {
+      "type": "text",
+      "key": "userId",
+      "label": "Mailbox",
+      "required": true,
+      "default": "me"
+    }
+  ],
+  defaultConfig: {
+    "mode": "auto"
+  },
+  renderBody: ({ config }) => summarize(GMAIL_INBOX_LABEL_LIST_META, config, "list labels")
+});
+var GMAIL_INBOX_MESSAGE_GET_KIND = "@particle-academy/gmail_inbox_message_get";
+var GMAIL_INBOX_MESSAGE_GET_OPERATION = "message_get";
+var GMAIL_INBOX_MESSAGE_GET_META = gmailInboxMeta("action", "read a message", "https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/get");
+var GMAIL_INBOX_MESSAGE_GET_OUTPUT = [
+  {
+    "path": "data.id",
+    "type": "string",
+    "description": "The message id."
+  },
+  {
+    "path": "data.threadId",
+    "type": "string",
+    "description": "The thread this message belongs to."
+  },
+  {
+    "path": "data.labelIds",
+    "type": "array",
+    "description": "System and user label ids currently on this message."
+  },
+  {
+    "path": "data.snippet",
+    "type": "string",
+    "description": "Gmail's own short plain-text preview of the body -- a few hundred characters, not the whole message."
+  },
+  {
+    "path": "data.internalDate",
+    "type": "string",
+    "description": "Unix epoch MILLISECONDS, as a string -- when Gmail received it, which can differ from the Date header."
+  },
+  {
+    "path": "data.payload.headers",
+    "type": "array",
+    "description": "Every RFC 2822 header as { name, value }, unparsed. From/To/Subject/Date live here."
+  },
+  {
+    "path": "data.payload",
+    "type": "unknown",
+    "description": "The full MIME tree, raw -- mimeType, body (base64url in body.data for a leaf part), and nested parts for a multipart message. Decode it yourself for plain-text or HTML content; this connector does not flatten it."
+  },
+  {
+    "path": "mode",
+    "type": "string",
+    "description": "Which estate this ran against. Google has no sandbox, so: fake or live."
+  }
+];
+var gmailInboxMessageGetKind = defineConnectorKind(GMAIL_INBOX_MESSAGE_GET_META, {
+  name: GMAIL_INBOX_MESSAGE_GET_KIND,
+  aliases: ["gmail_inbox_message_get"],
+  label: "Gmail message",
+  description: "Read one message's headers and preview. The body's plain/HTML text is NOT decoded -- see the raw payload for that.",
+  inputs: [{ id: "in" }],
+  outputs: [{ id: "out" }],
+  sideEffects: "none",
+  outputShape: GMAIL_INBOX_MESSAGE_GET_OUTPUT,
+  configSchema: [
+    {
+      "type": "text",
+      "key": "userId",
+      "label": "Mailbox",
+      "required": true,
+      "default": "me"
+    },
+    {
+      "type": "text",
+      "key": "id",
+      "label": "Message ID",
+      "required": true,
+      "description": "From message_list, or another node's output."
+    }
+  ],
+  defaultConfig: {
+    "mode": "auto"
+  },
+  renderBody: ({ config }) => summarize(GMAIL_INBOX_MESSAGE_GET_META, config, "read a message")
+});
+var GMAIL_INBOX_MESSAGE_LIST_KIND = "@particle-academy/gmail_inbox_message_list";
+var GMAIL_INBOX_MESSAGE_LIST_OPERATION = "message_list";
+var GMAIL_INBOX_MESSAGE_LIST_META = gmailInboxMeta("action", "list messages", "https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/list");
+var GMAIL_INBOX_MESSAGE_LIST_OUTPUT = [
+  {
+    "path": "data.messages",
+    "type": "array",
+    "description": "Each row is { id, threadId } only. Read a message's content with message_get."
+  },
+  {
+    "path": "data.nextPageToken",
+    "type": "string",
+    "description": "Present when there is another page."
+  },
+  {
+    "path": "data.resultSizeEstimate",
+    "type": "number",
+    "description": "Gmail's own word for it: an ESTIMATE, not an exact count."
+  },
+  {
+    "path": "mode",
+    "type": "string",
+    "description": "Which estate this ran against. Google has no sandbox, so: fake or live."
+  }
+];
+var gmailInboxMessageListKind = defineConnectorKind(GMAIL_INBOX_MESSAGE_LIST_META, {
+  name: GMAIL_INBOX_MESSAGE_LIST_KIND,
+  aliases: ["gmail_inbox_message_list"],
+  label: "List Gmail messages",
+  description: "List message ids matching a search, newest first.",
+  inputs: [{ id: "in" }],
+  outputs: [{ id: "out" }],
+  sideEffects: "none",
+  outputShape: GMAIL_INBOX_MESSAGE_LIST_OUTPUT,
+  configSchema: [
+    {
+      "type": "text",
+      "key": "userId",
+      "label": "Mailbox",
+      "required": true,
+      "default": "me",
+      "description": "`me` is the connected account and is almost always what you want."
+    },
+    {
+      "type": "text",
+      "key": "q",
+      "label": "Search",
+      "description": `Gmail's own search syntax, exactly as typed into the Gmail search box -- e.g. "from:ada@example.test has:attachment newer_than:7d". Leave blank to list everything.`
+    },
+    {
+      "type": "text",
+      "key": "labelId",
+      "label": "Label ID",
+      "description": "Only messages with this label -- e.g. INBOX, or a label_list id. Gmail's own query parameter accepts several, repeated; this connector offers one for now -- combine more in the search field above instead, using Gmail's own label: search operator."
+    },
+    {
+      "type": "switch",
+      "key": "includeSpamTrash",
+      "label": "Include spam and trash",
+      "default": false
+    },
+    {
+      "type": "number",
+      "key": "maxResults",
+      "label": "Page size",
+      "min": 1,
+      "max": 500,
+      "default": 100,
+      "description": "Gmail's own maximum is 500."
+    },
+    {
+      "type": "text",
+      "key": "pageToken",
+      "label": "Page token",
+      "description": "From a previous page's nextPageToken."
+    }
+  ],
+  defaultConfig: {
+    "mode": "auto"
+  },
+  renderBody: ({ config }) => summarize(GMAIL_INBOX_MESSAGE_LIST_META, config, "list messages")
+});
+var GMAIL_INBOX_THREAD_GET_KIND = "@particle-academy/gmail_inbox_thread_get";
+var GMAIL_INBOX_THREAD_GET_OPERATION = "thread_get";
+var GMAIL_INBOX_THREAD_GET_META = gmailInboxMeta("action", "read a thread", "https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.threads/get");
+var GMAIL_INBOX_THREAD_GET_OUTPUT = [
+  {
+    "path": "data.id",
+    "type": "string",
+    "description": "The thread id."
+  },
+  {
+    "path": "data.historyId",
+    "type": "string",
+    "description": "Gmail's change-tracking cursor as of this read."
+  },
+  {
+    "path": "data.messages",
+    "type": "array",
+    "description": "Every message in the thread, oldest first, each shaped like message_get's output."
+  },
+  {
+    "path": "mode",
+    "type": "string",
+    "description": "Which estate this ran against. Google has no sandbox, so: fake or live."
+  }
+];
+var gmailInboxThreadGetKind = defineConnectorKind(GMAIL_INBOX_THREAD_GET_META, {
+  name: GMAIL_INBOX_THREAD_GET_KIND,
+  aliases: ["gmail_inbox_thread_get"],
+  label: "Gmail thread",
+  description: "Read every message in a conversation thread, oldest first.",
+  inputs: [{ id: "in" }],
+  outputs: [{ id: "out" }],
+  sideEffects: "none",
+  outputShape: GMAIL_INBOX_THREAD_GET_OUTPUT,
+  configSchema: [
+    {
+      "type": "text",
+      "key": "userId",
+      "label": "Mailbox",
+      "required": true,
+      "default": "me"
+    },
+    {
+      "type": "text",
+      "key": "id",
+      "label": "Thread ID",
+      "required": true,
+      "description": "A message's threadId, from message_list or message_get."
+    }
+  ],
+  defaultConfig: {
+    "mode": "auto"
+  },
+  renderBody: ({ config }) => summarize(GMAIL_INBOX_THREAD_GET_META, config, "read a thread")
+});
+
+// src/index.ts
+var GMAIL_INBOX_KINDS = [
+  gmailInboxLabelListKind,
+  gmailInboxMessageGetKind,
+  gmailInboxMessageListKind,
+  gmailInboxThreadGetKind
+];
+
+export { CONNECTOR_API_VERSION, GMAIL_INBOX_CREDENTIALS, GMAIL_INBOX_KINDS, GMAIL_INBOX_LABEL_LIST_KIND, GMAIL_INBOX_LABEL_LIST_META, GMAIL_INBOX_LABEL_LIST_OPERATION, GMAIL_INBOX_LABEL_LIST_OUTPUT, GMAIL_INBOX_MESSAGE_GET_KIND, GMAIL_INBOX_MESSAGE_GET_META, GMAIL_INBOX_MESSAGE_GET_OPERATION, GMAIL_INBOX_MESSAGE_GET_OUTPUT, GMAIL_INBOX_MESSAGE_LIST_KIND, GMAIL_INBOX_MESSAGE_LIST_META, GMAIL_INBOX_MESSAGE_LIST_OPERATION, GMAIL_INBOX_MESSAGE_LIST_OUTPUT, GMAIL_INBOX_OAUTH, GMAIL_INBOX_SERVICE, GMAIL_INBOX_THREAD_GET_KIND, GMAIL_INBOX_THREAD_GET_META, GMAIL_INBOX_THREAD_GET_OPERATION, GMAIL_INBOX_THREAD_GET_OUTPUT, gmailInboxLabelListKind, gmailInboxMessageGetKind, gmailInboxMessageListKind, gmailInboxMeta, gmailInboxThreadGetKind };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map