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

package/dist/index.d.ts

@@ -0,0 +1,431 @@
+import { ServiceDescriptor, PreparedRequest, ConnectorMode, ConnectorFaker, RequestedMode, Transport, ConnectorResult, TriggerDescriptor, CursorReadSpec, DeliveryDecode, LeaseDeclaration, OidcJwtScheme, InboundDelivery, Jwk, WebhookVerification } 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/history-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/history-list.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- gmail_inbox
+ */
+/**
+ * List what changed in a mailbox since a history id: messages added or
+ * deleted, labels added or removed.
+ *
+ * GET /gmail/v1/users/{userId}/history —
+ * https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.history/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 HISTORY_LIST_OPERATION = "history_list";
+type HistoryListOptions = {
+    /** The node's resolved config. Keys: userId, startHistoryId, historyTypes, labelId, 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 gmailInboxHistoryList(options: HistoryListOptions): Promise<ConnectorResult>;
+
+/**
+ * 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/mailbox-stop.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/mailbox-stop.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- gmail_inbox
+ */
+/**
+ * Turn off push notifications for a mailbox.
+ *
+ * POST /gmail/v1/users/{userId}/stop —
+ * https://developers.google.com/workspace/gmail/api/reference/rest/v1/users/stop
+ *
+ * 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 MAILBOX_STOP_OPERATION = "mailbox_stop";
+type MailboxStopOptions = {
+    /** 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 gmailInboxMailboxStop(options: MailboxStopOptions): Promise<ConnectorResult>;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/mailbox-watch.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/mailbox-watch.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- gmail_inbox
+ */
+/**
+ * Start (or renew) push notifications for a mailbox to a Cloud Pub/Sub topic.
+ *
+ * POST /gmail/v1/users/{userId}/watch —
+ * https://developers.google.com/workspace/gmail/api/reference/rest/v1/users/watch
+ *
+ * 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 MAILBOX_WATCH_OPERATION = "mailbox_watch";
+type MailboxWatchOptions = {
+    /** The node's resolved config. Keys: userId, topicName, labelIds, labelFilterBehavior. */
+    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 gmailInboxMailboxWatch(options: MailboxWatchOptions): 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>;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/triggers/message-received.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/triggers/message-received.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- gmail_inbox
+ */
+/**
+ * Gmail Inbox's subscription trigger — the delivery contract.
+ *
+ * Kept beside the service descriptor rather than inside a node, because the
+ * way a delivery is verified is a fact about GMAIL INBOX. Two Gmail Inbox
+ * triggers must not be able to disagree about how a delivery is verified.
+ *
+ * A SUBSCRIPTION: Gmail Inbox stops delivering unless somebody renews it,
+ * forever, and if nobody does the workflow stops firing with no error
+ * anywhere. The lease below says where the expiry is read from and how early
+ * to renew; the host runs ONE renewal scheduler for every expiring trigger.
+ */
+
+/**
+ * How Gmail Inbox's push is authenticated: a bearer token in `Authorization`,
+ * signed by the provider, whose issuer must be one of these and whose
+ * principal claim must EQUAL the service account the host configured. The
+ * keys, the audience and the principal are the HOST's, passed to verify.
+ */
+declare const GMAIL_INBOX_MESSAGE_RECEIVED_OIDC_SCHEME: OidcJwtScheme;
+/**
+ * The lease this subscription carries: where the provider's expiry sits in the
+ * `mailbox_watch` response (`expiration`, epoch-ms), how early the host
+ * renews, and what it calls when the lease is due. The host builds the value
+ * with the core's `leaseFromResponse` and runs one scheduler for every
+ * expiring trigger.
+ */
+declare const GMAIL_INBOX_MESSAGE_RECEIVED_LEASE: LeaseDeclaration;
+/**
+ * Which of this package's actions create, renew and stop the subscription.
+ * `renew` is null where the provider cannot renew and the host calls create
+ * again — after stopping the old one, and after re-listing, because
+ * notifications during the gap are gone.
+ */
+declare const GMAIL_INBOX_MESSAGE_RECEIVED_SUBSCRIPTION: {
+    readonly create: "mailbox_watch";
+    readonly renew: "mailbox_watch";
+    readonly stop: "mailbox_stop";
+};
+declare const GMAIL_INBOX_MESSAGE_RECEIVED_DECODE: DeliveryDecode;
+declare const GMAIL_INBOX_MESSAGE_RECEIVED: TriggerDescriptor;
+/**
+ * Where the follow-up read's cursor goes and comes from. The HOST stores it:
+ * seeded from the `mailbox_watch` response's `historyId`, advanced to
+ * `cursor.next` after each successful run, and filled into this trigger's
+ * config on every run.
+ */
+declare const GMAIL_INBOX_MESSAGE_RECEIVED_CURSOR: CursorReadSpec;
+/**
+ * Read what changed since the HOST's stored cursor: `history_list` from
+ * `config.startHistoryId`, every page, `history` concatenated, published under
+ * `history` with `cursor: {used, next}`. Persist `cursor.next` once the run
+ * succeeds. A lapsed cursor (cursor-expired) or too many pages
+ * (cursor-overflow) is refused BY NAME with the bounded resync query, and a
+ * missing one (cursor-missing) calls nothing. In fake mode with no stored
+ * cursor the read is faked from a placeholder, so the node runs on a canvas.
+ */
+declare function readGmailInboxMessageReceivedAfter(event: unknown, config: Record<string, unknown>, options?: {
+    credentials?: Record<string, string | undefined>;
+    transport?: Transport;
+}): Promise<Record<string, unknown>>;
+/**
+ * Verify one inbound Gmail Inbox delivery.
+ *
+ * The host calls this BEFORE starting a run. The body proves nothing here: the
+ * delivery is authenticated by the bearer token in its header. `keys` are the
+ * provider's signing keys (its JWKS `keys`), fetched and cached by the HOST;
+ * nothing in this package fetches them. `pushAudience` and
+ * `pushServiceAccount` are the connection's, and both are REQUIRED: an
+ * unchecked audience accepts every token the provider signs for anyone, and an
+ * unchecked principal accepts a stranger's subscription aimed at your URL. Any
+ * of the three missing refuses every delivery.
+ */
+declare function verifyGmailInboxDelivery(delivery: InboundDelivery, expected: {
+    keys: readonly Jwk[];
+    pushAudience: string | undefined;
+    pushServiceAccount: string | undefined;
+}, now?: number): Promise<WebhookVerification>;
+/**
+ * Read one VERIFIED Gmail Inbox delivery.
+ *
+ * The body is not plain JSON: it is pubsub-push, the provider's envelope,
+ * unwrapped to the message it carries. The host calls this AFTER
+ * `verifyGmailInboxDelivery` has accepted the delivery, with the SAME raw
+ * bytes, and starts the run with what it returns. A body that cannot be read
+ * is refused by name, never passed on.
+ */
+declare function decodeGmailInboxDelivery(raw: Uint8Array | string): unknown;
+
+export { CONNECTOR_API_VERSION, GMAIL_INBOX, GMAIL_INBOX_BASE_URLS, GMAIL_INBOX_MESSAGE_RECEIVED, GMAIL_INBOX_MESSAGE_RECEIVED_CURSOR, GMAIL_INBOX_MESSAGE_RECEIVED_DECODE, GMAIL_INBOX_MESSAGE_RECEIVED_LEASE, GMAIL_INBOX_MESSAGE_RECEIVED_OIDC_SCHEME, GMAIL_INBOX_MESSAGE_RECEIVED_SUBSCRIPTION, GMAIL_INBOX_REQUIRES, HISTORY_LIST_OPERATION, type HistoryListOptions, LABEL_LIST_OPERATION, type LabelListOptions, MAILBOX_STOP_OPERATION, MAILBOX_WATCH_OPERATION, MESSAGE_GET_OPERATION, MESSAGE_LIST_OPERATION, type MailboxStopOptions, type MailboxWatchOptions, type MessageGetOptions, type MessageListOptions, THREAD_GET_OPERATION, type ThreadGetOptions, decodeGmailInboxDelivery, gmailInboxAuthorize, gmailInboxFaker, gmailInboxHistoryList, gmailInboxLabelList, gmailInboxMailboxStop, gmailInboxMailboxWatch, gmailInboxMessageGet, gmailInboxMessageList, gmailInboxThreadGet, readGmailInboxMessageReceivedAfter, verifyGmailInboxDelivery };

package/dist/index.js

@@ -0,0 +1,3 @@
+export { CONNECTOR_API_VERSION, GMAIL_INBOX, GMAIL_INBOX_BASE_URLS, GMAIL_INBOX_MESSAGE_RECEIVED, GMAIL_INBOX_MESSAGE_RECEIVED_CURSOR, GMAIL_INBOX_MESSAGE_RECEIVED_DECODE, GMAIL_INBOX_MESSAGE_RECEIVED_LEASE, GMAIL_INBOX_MESSAGE_RECEIVED_OIDC_SCHEME, GMAIL_INBOX_MESSAGE_RECEIVED_SUBSCRIPTION, GMAIL_INBOX_REQUIRES, HISTORY_LIST_OPERATION, LABEL_LIST_OPERATION, MAILBOX_STOP_OPERATION, MAILBOX_WATCH_OPERATION, MESSAGE_GET_OPERATION, MESSAGE_LIST_OPERATION, THREAD_GET_OPERATION, decodeGmailInboxDelivery, gmailInboxAuthorize, gmailInboxFaker, gmailInboxHistoryList, gmailInboxLabelList, gmailInboxMailboxStop, gmailInboxMailboxWatch, gmailInboxMessageGet, gmailInboxMessageList, gmailInboxThreadGet, readGmailInboxMessageReceivedAfter, verifyGmailInboxDelivery } from './chunk-2PSRTESV.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -1,18 +1,90 @@
 {
   "name": "@particle-academy/gmail-inbox-js",
-  "version": "0.0.0",
-  "description": "A placeholder that claims the name @particle-academy/gmail-inbox-js; the real release follows through Fancy-Friends/gmail-inbox's publish.yml with provenance. Do not install this version.",
-  "license": "MIT",
+  "version": "0.2.0",
+  "description": "Gmail Inbox for Node — the service descriptor, its faker, its webhook verification, and one function per operation. Plain HTTP on @particle-academy/fancy-connector-core; no vendor SDK.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Fancy-Friends/gmail-inbox.git",
     "directory": "packages/js"
   },
   "homepage": "https://github.com/Fancy-Friends/gmail-inbox#readme",
+  "bugs": "https://github.com/Fancy-Friends/gmail-inbox/issues",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./flow": {
+      "import": {
+        "types": "./dist/flow.d.ts",
+        "default": "./dist/flow.js"
+      },
+      "require": {
+        "types": "./dist/flow.d.cts",
+        "default": "./dist/flow.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "art",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "lint": "tsc --noEmit",
+    "test": "node --import tsx --test tests/*.test.ts",
+    "prepublishOnly": "tsup"
+  },
+  "dependencies": {
+    "@particle-academy/fancy-connector-core": ">=0.14.0 <2.0"
+  },
+  "peerDependencies": {
+    "@particle-academy/fancy-flow": ">=0.47.1 <2.0",
+    "@particle-academy/gmail-inbox-ui": ">=0.2.0 <0.3.0"
+  },
+  "peerDependenciesMeta": {
+    "@particle-academy/fancy-flow": {
+      "optional": true
+    },
+    "@particle-academy/gmail-inbox-ui": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@particle-academy/fancy-flow": ">=0.47.1 <2.0",
+    "@types/node": "^26.2.0",
+    "tsup": "^8.5.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0"
+  },
   "publishConfig": {
     "access": "public"
   },
-  "files": [
-    "README.md"
-  ]
+  "keywords": [
+    "gmail_inbox",
+    "email",
+    "connector",
+    "api",
+    "fancy-ui",
+    "particle-academy"
+  ],
+  "license": "MIT",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  }
 }