npm - @ganju/utils - Versions diffs - 0.0.1 - Mend

@ganju/utils 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (220) hide show

package/LICENSE +201 -0
package/NOTICE +9 -0
package/README.md +23 -0
package/dist/apiError.d.ts +3 -0
package/dist/apiError.d.ts.map +1 -0
package/dist/apiError.js +36 -0
package/dist/attachment.d.ts +33 -0
package/dist/attachment.d.ts.map +1 -0
package/dist/attachment.js +59 -0
package/dist/base64.d.ts +10 -0
package/dist/base64.d.ts.map +1 -0
package/dist/base64.js +50 -0
package/dist/channelDebounce.d.ts +26 -0
package/dist/channelDebounce.d.ts.map +1 -0
package/dist/channelDebounce.js +35 -0
package/dist/channelNotifier.d.ts +9 -0
package/dist/channelNotifier.d.ts.map +1 -0
package/dist/channelNotifier.js +31 -0
package/dist/chunking.d.ts +28 -0
package/dist/chunking.d.ts.map +1 -0
package/dist/chunking.js +97 -0
package/dist/cliConstants.d.ts +9 -0
package/dist/cliConstants.d.ts.map +1 -0
package/dist/cliConstants.js +47 -0
package/dist/coerce.d.ts +2 -0
package/dist/coerce.d.ts.map +1 -0
package/dist/coerce.js +13 -0
package/dist/constants.d.ts +624 -0
package/dist/constants.d.ts.map +1 -0
package/dist/constants.js +2220 -0
package/dist/crypto.d.ts +14 -0
package/dist/crypto.d.ts.map +1 -0
package/dist/crypto.js +93 -0
package/dist/customCodeProject.d.ts +91 -0
package/dist/customCodeProject.d.ts.map +1 -0
package/dist/customCodeProject.js +154 -0
package/dist/customCodeToken.d.ts +41 -0
package/dist/customCodeToken.d.ts.map +1 -0
package/dist/customCodeToken.js +115 -0
package/dist/deadline.d.ts +6 -0
package/dist/deadline.d.ts.map +1 -0
package/dist/deadline.js +45 -0
package/dist/discordSend.d.ts +25 -0
package/dist/discordSend.d.ts.map +1 -0
package/dist/discordSend.js +8 -0
package/dist/embeddable.d.ts +2 -0
package/dist/embeddable.d.ts.map +1 -0
package/dist/embeddable.js +6 -0
package/dist/exposedResource.d.ts +6 -0
package/dist/exposedResource.d.ts.map +1 -0
package/dist/exposedResource.js +18 -0
package/dist/extractedDocument.d.ts +70 -0
package/dist/extractedDocument.d.ts.map +1 -0
package/dist/extractedDocument.js +2 -0
package/dist/fetcher.d.ts +8 -0
package/dist/fetcher.d.ts.map +1 -0
package/dist/fetcher.js +68 -0
package/dist/formatFilename.d.ts +2 -0
package/dist/formatFilename.d.ts.map +1 -0
package/dist/formatFilename.js +19 -0
package/dist/formatRelative.d.ts +12 -0
package/dist/formatRelative.d.ts.map +1 -0
package/dist/formatRelative.js +28 -0
package/dist/formatRelativeTime.d.ts +2 -0
package/dist/formatRelativeTime.d.ts.map +1 -0
package/dist/formatRelativeTime.js +49 -0
package/dist/getEnv.d.ts +5 -0
package/dist/getEnv.d.ts.map +1 -0
package/dist/getEnv.js +11 -0
package/dist/gmailSend.d.ts +24 -0
package/dist/gmailSend.d.ts.map +1 -0
package/dist/gmailSend.js +9 -0
package/dist/index.d.ts +2839 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +155 -0
package/dist/jsonSchemaToZodShape.d.ts +38 -0
package/dist/jsonSchemaToZodShape.d.ts.map +1 -0
package/dist/jsonSchemaToZodShape.js +117 -0
package/dist/l2Normalize.d.ts +2 -0
package/dist/l2Normalize.d.ts.map +1 -0
package/dist/l2Normalize.js +25 -0
package/dist/languageCookieDomain.d.ts +21 -0
package/dist/languageCookieDomain.d.ts.map +1 -0
package/dist/languageCookieDomain.js +39 -0
package/dist/localizeZodIssue.d.ts +43 -0
package/dist/localizeZodIssue.d.ts.map +1 -0
package/dist/localizeZodIssue.js +90 -0
package/dist/mailHeaders.d.ts +4 -0
package/dist/mailHeaders.d.ts.map +1 -0
package/dist/mailHeaders.js +11 -0
package/dist/mcpProxy.d.ts +2 -0
package/dist/mcpProxy.d.ts.map +1 -0
package/dist/mcpProxy.js +21 -0
package/dist/mimeMessage.d.ts +21 -0
package/dist/mimeMessage.d.ts.map +1 -0
package/dist/mimeMessage.js +58 -0
package/dist/oauth.d.ts +21 -0
package/dist/oauth.d.ts.map +1 -0
package/dist/oauth.js +75 -0
package/dist/oauthProviders.d.ts +12 -0
package/dist/oauthProviders.d.ts.map +1 -0
package/dist/oauthProviders.js +99 -0
package/dist/outlookSend.d.ts +19 -0
package/dist/outlookSend.d.ts.map +1 -0
package/dist/outlookSend.js +9 -0
package/dist/parseHttpError.d.ts +2 -0
package/dist/parseHttpError.d.ts.map +1 -0
package/dist/parseHttpError.js +23 -0
package/dist/planLimitError.d.ts +18 -0
package/dist/planLimitError.d.ts.map +1 -0
package/dist/planLimitError.js +35 -0
package/dist/processQueueBatch.d.ts +17 -0
package/dist/processQueueBatch.d.ts.map +1 -0
package/dist/processQueueBatch.js +32 -0
package/dist/reservedToolName.d.ts +16 -0
package/dist/reservedToolName.d.ts.map +1 -0
package/dist/reservedToolName.js +25 -0
package/dist/resourceUri.d.ts +2 -0
package/dist/resourceUri.d.ts.map +1 -0
package/dist/resourceUri.js +19 -0
package/dist/retry.d.ts +10 -0
package/dist/retry.d.ts.map +1 -0
package/dist/retry.js +37 -0
package/dist/sanitize.d.ts +7 -0
package/dist/sanitize.d.ts.map +1 -0
package/dist/sanitize.js +69 -0
package/dist/schema.d.ts +2175 -0
package/dist/schema.d.ts.map +1 -0
package/dist/schema.js +1382 -0
package/dist/sdkConstants.d.ts +15 -0
package/dist/sdkConstants.d.ts.map +1 -0
package/dist/sdkConstants.js +43 -0
package/dist/slackSend.d.ts +38 -0
package/dist/slackSend.d.ts.map +1 -0
package/dist/slackSend.js +14 -0
package/dist/slug.d.ts +5 -0
package/dist/slug.d.ts.map +1 -0
package/dist/slug.js +34 -0
package/dist/slugifyTitle.d.ts +2 -0
package/dist/slugifyTitle.d.ts.map +1 -0
package/dist/slugifyTitle.js +11 -0
package/dist/sources.d.ts +43 -0
package/dist/sources.d.ts.map +1 -0
package/dist/sources.js +73 -0
package/dist/ssrf.d.ts +3 -0
package/dist/ssrf.d.ts.map +1 -0
package/dist/ssrf.js +46 -0
package/dist/tallyUsageKinds.d.ts +9 -0
package/dist/tallyUsageKinds.d.ts.map +1 -0
package/dist/tallyUsageKinds.js +20 -0
package/dist/telegramSend.d.ts +28 -0
package/dist/telegramSend.d.ts.map +1 -0
package/dist/telegramSend.js +9 -0
package/dist/toolCatalog.d.ts +452 -0
package/dist/toolCatalog.d.ts.map +1 -0
package/dist/toolCatalog.js +552 -0
package/dist/validateMessageVariables.d.ts +7 -0
package/dist/validateMessageVariables.d.ts.map +1 -0
package/dist/validateMessageVariables.js +16 -0
package/dist/vendorError.d.ts +2 -0
package/dist/vendorError.d.ts.map +1 -0
package/dist/vendorError.js +25 -0
package/dist/whatsappSend.d.ts +31 -0
package/dist/whatsappSend.d.ts.map +1 -0
package/dist/whatsappSend.js +11 -0
package/package.json +76 -0
package/src/apiError.ts +40 -0
package/src/attachment.ts +97 -0
package/src/base64.ts +60 -0
package/src/channelDebounce.ts +76 -0
package/src/channelNotifier.ts +39 -0
package/src/chunking.ts +131 -0
package/src/cliConstants.ts +50 -0
package/src/coerce.ts +9 -0
package/src/constants.ts +2542 -0
package/src/crypto.ts +108 -0
package/src/customCodeProject.ts +182 -0
package/src/customCodeToken.ts +198 -0
package/src/deadline.ts +43 -0
package/src/discordSend.ts +41 -0
package/src/embeddable.ts +4 -0
package/src/exposedResource.ts +40 -0
package/src/extractedDocument.ts +62 -0
package/src/fetcher.ts +82 -0
package/src/formatFilename.ts +19 -0
package/src/formatRelative.ts +36 -0
package/src/formatRelativeTime.ts +45 -0
package/src/getEnv.ts +13 -0
package/src/gmailSend.ts +34 -0
package/src/index.ts +397 -0
package/src/jsonSchemaToZodShape.ts +111 -0
package/src/l2Normalize.ts +19 -0
package/src/languageCookieDomain.ts +37 -0
package/src/localizeZodIssue.ts +124 -0
package/src/mailHeaders.ts +12 -0
package/src/mcpProxy.ts +20 -0
package/src/mimeMessage.ts +82 -0
package/src/oauth.ts +103 -0
package/src/oauthProviders.ts +118 -0
package/src/outlookSend.ts +44 -0
package/src/parseHttpError.ts +16 -0
package/src/planLimitError.ts +50 -0
package/src/processQueueBatch.ts +46 -0
package/src/reservedToolName.ts +27 -0
package/src/resourceUri.ts +17 -0
package/src/retry.ts +43 -0
package/src/sanitize.ts +67 -0
package/src/schema.ts +1624 -0
package/src/sdkConstants.ts +44 -0
package/src/slackSend.ts +65 -0
package/src/slug.ts +37 -0
package/src/slugifyTitle.ts +8 -0
package/src/sources.ts +117 -0
package/src/ssrf.ts +34 -0
package/src/tallyUsageKinds.ts +20 -0
package/src/telegramSend.ts +39 -0
package/src/toolCatalog.ts +635 -0
package/src/validateMessageVariables.ts +18 -0
package/src/vendorError.ts +19 -0
package/src/whatsappSend.ts +47 -0

package/src/fetcher.ts ADDED Viewed

@@ -0,0 +1,82 @@
+import { GetServerSidePropsContext } from 'next';
+export interface IFetcherProps {
+  url: string;
+  config?: RequestInit;
+  ssrContext?: GetServerSidePropsContext;
+}
+/**
+ * The language the API should answer in.
+ *
+ * Not the browser's `Accept-Language`: someone in Bogotá running Chrome in
+ * English, or someone who picked a language in the switcher, would have the
+ * header disagree with the page they are looking at. This sends what the app is
+ * actually rendering, from the one place that always knows.
+ *
+ * `Accept-Language` is the right header for it and is CORS-safelisted, so
+ * cross-origin calls to the API pick up no preflight for carrying it.
+ */
+const requestLanguage = (ssrContext?: GetServerSidePropsContext) => {
+  // On the server, the locale Next resolved for this request.
+  if (ssrContext?.locale) return ssrContext.locale;
+  // In the browser, `_document.tsx` sets `<html lang>` from that same locale,
+  // so it is guaranteed to match what the reader is looking at.
+  if (typeof document !== 'undefined') {
+    return document.documentElement.lang || undefined;
+  }
+  return undefined;
+};
+/** `HeadersInit` in any of its three shapes, flattened so it can be merged. */
+const toRecord = (init?: HeadersInit): Record<string, string> => {
+  if (!init) return {};
+  const entries =
+    typeof Headers !== 'undefined' && init instanceof Headers
+      ? Array.from(init.entries())
+      : Array.isArray(init)
+        ? init
+        : Object.entries(init);
+  const record: Record<string, string> = {};
+  for (const [key, value] of entries) record[key] = value;
+  return record;
+};
+export const fetcher = async (props: IFetcherProps) => {
+  const { url, config: fetchConfig, ssrContext } = props;
+  const isFormData =
+    typeof FormData !== 'undefined' && fetchConfig?.body instanceof FormData;
+  const language = requestLanguage(ssrContext);
+  // FormData sets its own Content-Type, boundary included — naming it here
+  // would corrupt the body.
+  const headers: Record<string, string> = isFormData
+    ? {}
+    : { 'Content-Type': 'application/json' };
+  if (language) {
+    headers['Accept-Language'] = language;
+  }
+  const response = await fetch(`${process.env.NEXT_PUBLIC_API_URL}${url}`, {
+    ...fetchConfig,
+    // Merged rather than overwritten. Spreading `fetchConfig` last used to
+    // replace this object wholesale, so every SSR call that forwards a `cookie`
+    // header silently dropped the ones set here.
+    headers: { ...headers, ...toRecord(fetchConfig?.headers) }
+  });
+  if (ssrContext) {
+    const cookie = response.headers.get('set-cookie');
+    if (cookie) {
+      ssrContext.res.setHeader('Set-Cookie', cookie);
+    }
+  }
+  const json = await response.json();
+  return json;
+};

package/src/formatFilename.ts ADDED Viewed

@@ -0,0 +1,19 @@
+const cleanFilenamePart = (s: string): string =>
+  s
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+export const formatFilename = (filename: string): string => {
+  const lastDot = filename.lastIndexOf('.');
+  // lastDot > 0 skips dotfiles like ".gitignore"; the upper bound skips trailing-dot files like "foo."
+  const hasExtension = lastDot > 0 && lastDot < filename.length - 1;
+  const basename = hasExtension ? filename.slice(0, lastDot) : filename;
+  const extension = hasExtension ? filename.slice(lastDot + 1) : '';
+  const timestamp = Date.now();
+  const randomString = Math.random().toString(36).slice(2, 7);
+  const stem = cleanFilenamePart(`${basename}-${timestamp}-${randomString}`);
+  return extension ? `${stem}.${cleanFilenamePart(extension)}` : stem;
+};

package/src/formatRelative.ts ADDED Viewed

@@ -0,0 +1,36 @@
+import dayjs from 'dayjs';
+import relativeTime from 'dayjs/plugin/relativeTime';
+import 'dayjs/locale/es';
+dayjs.extend(relativeTime);
+export interface FormatRelativeOptions {
+  /**
+   * BCP-47 tag of the language to answer in — `t.locale` in the dashboard.
+   * Anything that is not Spanish falls through to English.
+   */
+  locale?: string;
+  /** Rendered when there is no date to describe. Copy, so callers translate it. */
+  fallback?: string;
+}
+/**
+ * dayjs ships one file per language and matches on its own short names, not on
+ * BCP-47 tags: `es-CO` is not a locale it knows, `es` is.
+ */
+const dayjsLocale = (locale?: string): string =>
+  locale?.startsWith('es') ? 'es' : 'en';
+export const formatRelative = (
+  value: string | number | Date | null | undefined,
+  options: FormatRelativeOptions = {}
+): string => {
+  const { locale, fallback = 'Never' } = options;
+  if (!value) return fallback;
+  const d = dayjs(value);
+  if (!d.isValid()) return fallback;
+  // Per instance, never `dayjs.locale(…)`: that sets a module-level global, and
+  // a Workers isolate serves requests of mixed languages concurrently — the same
+  // reason `localizeZodIssue` refuses `z.config()`.
+  return d.locale(dayjsLocale(locale)).fromNow();
+};

package/src/formatRelativeTime.ts ADDED Viewed

@@ -0,0 +1,45 @@
+// Compact relative time — "5m ago", "3h ago", "2d ago", then falls back to a
+// locale date once older than a week.
+//
+// The wording comes from `Intl.RelativeTimeFormat` in its narrow style, which
+// renders exactly the shape the dashboard already used in English and gives
+// Spanish "hace 5 min" for free. Nothing here is translatable copy.
+const DEFAULT_LOCALE = 'en-US';
+// The constructor is the expensive part and this runs inside lists, so build one
+// per locale and keep it. `auto` lets the zero case read as "now" / "ahora"
+// rather than "in 0 seconds".
+const formatters = new Map<string, Intl.RelativeTimeFormat>();
+const relativeFormat = (locale: string): Intl.RelativeTimeFormat => {
+  const hit = formatters.get(locale);
+  if (hit) return hit;
+  const made = new Intl.RelativeTimeFormat(locale, {
+    style: 'narrow',
+    numeric: 'auto'
+  });
+  formatters.set(locale, made);
+  return made;
+};
+export const formatRelativeTime = (
+  iso?: string | null,
+  locale: string = DEFAULT_LOCALE
+): string => {
+  if (!iso) return '';
+  const date = new Date(iso);
+  if (Number.isNaN(date.getTime())) return '';
+  const diff = Date.now() - date.getTime();
+  const minute = 60_000;
+  const hour = 60 * minute;
+  const day = 24 * hour;
+  const rtf = relativeFormat(locale);
+  // A future timestamp lands here too, and reads as "now" rather than a
+  // negative age — same as before.
+  if (diff < minute) return rtf.format(0, 'second');
+  if (diff < hour) return rtf.format(-Math.floor(diff / minute), 'minute');
+  if (diff < day) return rtf.format(-Math.floor(diff / hour), 'hour');
+  if (diff < 7 * day) return rtf.format(-Math.floor(diff / day), 'day');
+  return date.toLocaleDateString(locale);
+};

package/src/getEnv.ts ADDED Viewed

@@ -0,0 +1,13 @@
+export interface EnvSource {
+  env?: Record<string, unknown> | unknown;
+}
+export const getEnv = (
+  source: EnvSource,
+  key: string
+): string | undefined => {
+  const env = (source.env as Record<string, unknown> | undefined) || undefined;
+  const value = env?.[key];
+  if (typeof value === 'string') return value;
+  return process.env[key];
+};

package/src/gmailSend.ts ADDED Viewed

@@ -0,0 +1,34 @@
+// Wire protocol shared between the worker (which constructs the request) and
+// the resource-handler container (which parses it and calls the Gmail API).
+//
+// The worker sends a multipart/form-data POST with one `metadata` field (JSON
+// matching GmailSendRequest) and zero-or-more `attachment` fields (binary
+// files). Encoding the multipart MIME body and base64-ing attachments happens
+// in the container, where memory isn't capped at 128MB.
+export type GmailOperation =
+  | 'send-email'
+  | 'reply-email'
+  | 'create-draft'
+  | 'update-draft';
+export interface GmailSendRequest {
+  accessToken: string;
+  operation: GmailOperation;
+  to: string;
+  body: string;
+  subject?: string;
+  cc?: string;
+  bcc?: string;
+  contentType?: 'text/html' | 'text/plain';
+  inReplyTo?: string;
+  references?: string;
+  threadId?: string;
+  draftId?: string;
+}
+export interface GmailSendResponse {
+  id: string;
+  threadId?: string;
+  message?: { id: string; threadId?: string };
+}

package/src/index.ts ADDED Viewed

@@ -0,0 +1,397 @@
+import { Schema } from './schema';
+import type {
+  HttpEndpointToolConfig,
+  McpProxyToolConfig,
+  McpProxyDiscoveredTool,
+  McpProxyDiscoveredResource,
+  McpProxyDiscoveredPrompt,
+  McpProxyDiscovery,
+  CustomCodeToolConfig,
+  CustomCodeToolManifest,
+  CustomCodeManifest,
+  CustomCodeSendFile,
+  CustomCodeCreateResource
+} from './schema';
+import { getEnv } from './getEnv';
+import type { EnvSource } from './getEnv';
+import type { CalendarConfigField } from './constants';
+import { fetcher } from './fetcher';
+import { constants } from './constants';
+import {
+  generateRandomSlug,
+  generateRandomToken,
+  isReservedSlug,
+  isValidSlugFormat
+} from './slug';
+import { isReservedToolName } from './reservedToolName';
+import {
+  encryptString,
+  decryptString,
+  getCredentialEncryptionKey,
+  sha256Hex,
+  sha256Base64Url,
+  hmacSha256Hex,
+  timingSafeEqual
+} from './crypto';
+import {
+  bytesToBase64,
+  base64ToBytes,
+  hexToBytes,
+  utf8ToBase64,
+  base64ToUtf8,
+  toBase64Url,
+  fromBase64Url,
+  utf8ToBase64Url,
+  base64UrlToUtf8
+} from './base64';
+import {
+  sanitizeMailHeader,
+  encodeRfc2047,
+  formatMailHeader
+} from './mailHeaders';
+import {
+  buildMimeMessage,
+  sanitizeFilename,
+  formatFilenameHeader,
+  chunkBase64
+} from './mimeMessage';
+import type { MimeAttachment, MimeMessageInput } from './mimeMessage';
+import type {
+  GmailOperation,
+  GmailSendRequest,
+  GmailSendResponse
+} from './gmailSend';
+import type {
+  TelegramSendRequest,
+  TelegramSendResponse,
+  TelegramSendRemoteResourceRequest
+} from './telegramSend';
+import type {
+  OutlookOperation,
+  OutlookSendRequest,
+  OutlookSendResponse
+} from './outlookSend';
+import type {
+  SlackOperation,
+  SlackSendRequest,
+  SlackSendResponse,
+  SlackSendRemoteResourceRequest
+} from './slackSend';
+import type {
+  DiscordSendRequest,
+  DiscordSendResponse,
+  DiscordSendRemoteResourceRequest
+} from './discordSend';
+import type {
+  WhatsappSendRequest,
+  WhatsappSendResponse,
+  WhatsappSendRemoteResourceRequest
+} from './whatsappSend';
+import { parseHttpErrorMessage } from './parseHttpError';
+import { isApiError, getApiErrorMessage } from './apiError';
+import { toStringArray } from './coerce';
+import { validateMessageVariables } from './validateMessageVariables';
+import {
+  JsonSchema,
+  jsonSchemaToZodShape,
+  validateAgainstJsonSchema
+} from './jsonSchemaToZodShape';
+import type { SchemaViolation } from './jsonSchemaToZodShape';
+import { buildProxyToolName } from './mcpProxy';
+import {
+  mintCustomCodeToken,
+  verifyCustomCodeToken,
+  customCodeScriptName,
+  customCodePreviewScriptName
+} from './customCodeToken';
+import type { CustomCodeTokenPayload } from './customCodeToken';
+import { oauthProviders } from './oauthProviders';
+import type { OAuthProviderConfig } from './oauthProviders';
+import { resolveAttachment } from './attachment';
+import { isExposedResource } from './exposedResource';
+import type { ExposableResource } from './exposedResource';
+import { describeVendorError } from './vendorError';
+import { withDeadline, isDeadlineError } from './deadline';
+import {
+  CUSTOM_CODE_PROJECT_MARKER,
+  encodeProject,
+  decodeProject,
+  validateProjectFiles,
+  validateProjectPath,
+  projectPathIssue
+} from './customCodeProject';
+import type { CustomCodeProject, ProjectPathIssue } from './customCodeProject';
+import type {
+  AttachmentResource,
+  ResolvedAttachment,
+  ResolveAttachmentResult
+} from './attachment';
+import { ipv4InPrivateRange, isBlockedHost } from './ssrf';
+import { formatRelative } from './formatRelative';
+import { formatRelativeTime } from './formatRelativeTime';
+import { languageCookieDomain } from './languageCookieDomain';
+import { localizeZodIssue, languageFromHeader } from './localizeZodIssue';
+import { slugifyTitle } from './slugifyTitle';
+import { resourceUriFromTitle } from './resourceUri';
+import {
+  TOOL_CATALOG,
+  TOOL_KEYS,
+  describeCatalogTool,
+  findCatalogGroup,
+  findCatalogTool,
+  isToolKey
+} from './toolCatalog';
+import type {
+  CatalogGroup,
+  CatalogTool,
+  CatalogToolDescriptor,
+  ToolGroupKey,
+  ToolKey
+} from './toolCatalog';
+import { tallyUsageKinds } from './tallyUsageKinds';
+import { formatFilename } from './formatFilename';
+import {
+  decodeEntities,
+  escapeHtml,
+  parseOpenXmlProps,
+  stripBase64Images,
+  sanitizeMetadataString,
+  serializeMetadataValue
+} from './sanitize';
+import {
+  chunkText,
+  splitRecursive,
+  buildHeader,
+  prepareChunks
+} from './chunking';
+import type { Separator, ChunkMetadata, PreparedChunk } from './chunking';
+import { isEmbeddableMimeType } from './embeddable';
+import { l2Normalize } from './l2Normalize';
+import { sleep, isRateLimitError, withRateLimitRetry } from './retry';
+import type { RateLimitRetryOptions } from './retry';
+import { processQueueBatch } from './processQueueBatch';
+import type {
+  QueueBatchLike,
+  QueueMessageLike,
+  ProcessQueueBatchHandlers
+} from './processQueueBatch';
+import type {
+  ExtractedDocument,
+  ExtractedDocumentMetadata,
+  ExtractedDocumentSource
+} from './extractedDocument';
+import { getToolStatusMessage } from './channelNotifier';
+import type { ChannelNotifier, ToolStatusEvent } from './channelNotifier';
+import {
+  resolveDebounceMs,
+  channelBufferKey,
+  joinBufferedMessages
+} from './channelDebounce';
+import type {
+  BufferedChannelMessage,
+  ChannelBufferEnvelope,
+  ChannelBufferFlush
+} from './channelDebounce';
+import {
+  isResourceSourceEnabled,
+  isDownloadableSource,
+  safeHostname,
+  buildResourceDownloadUrl,
+  formatSourcesAsMarkdown,
+  formatSourcesAsButtons
+} from './sources';
+import type { Source, ResourceUrlContext, SourceButton } from './sources';
+import {
+  refreshOAuthToken,
+  OAuthReauthRequiredError,
+  buildReauthMetadata,
+  clearReauthMetadata,
+  isCredentialNeedingReauth
+} from './oauth';
+import type { RefreshOAuthTokenInput, RefreshedOAuthToken } from './oauth';
+import { PlanLimitError, isPlanLimitError } from './planLimitError';
+import type { PlanLimitDetails } from './planLimitError';
+import type { PlanLimits } from './constants';
+export const utils = {
+  Schema,
+  getEnv,
+  fetcher,
+  constants,
+  generateRandomSlug,
+  generateRandomToken,
+  isReservedSlug,
+  isValidSlugFormat,
+  isReservedToolName,
+  encryptString,
+  decryptString,
+  getCredentialEncryptionKey,
+  sha256Hex,
+  sha256Base64Url,
+  hmacSha256Hex,
+  timingSafeEqual,
+  bytesToBase64,
+  base64ToBytes,
+  hexToBytes,
+  utf8ToBase64,
+  base64ToUtf8,
+  toBase64Url,
+  fromBase64Url,
+  utf8ToBase64Url,
+  base64UrlToUtf8,
+  sanitizeMailHeader,
+  encodeRfc2047,
+  formatMailHeader,
+  buildMimeMessage,
+  sanitizeFilename,
+  formatFilenameHeader,
+  chunkBase64,
+  parseHttpErrorMessage,
+  isApiError,
+  getApiErrorMessage,
+  toStringArray,
+  jsonSchemaToZodShape,
+  validateAgainstJsonSchema,
+  buildProxyToolName,
+  mintCustomCodeToken,
+  verifyCustomCodeToken,
+  customCodeScriptName,
+  customCodePreviewScriptName,
+  oauthProviders,
+  resolveAttachment,
+  isExposedResource,
+  describeVendorError,
+  withDeadline,
+  isDeadlineError,
+  CUSTOM_CODE_PROJECT_MARKER,
+  encodeProject,
+  decodeProject,
+  validateProjectFiles,
+  validateProjectPath,
+  projectPathIssue,
+  ipv4InPrivateRange,
+  isBlockedHost,
+  validateMessageVariables,
+  formatRelative,
+  formatRelativeTime,
+  languageCookieDomain,
+  localizeZodIssue,
+  languageFromHeader,
+  slugifyTitle,
+  resourceUriFromTitle,
+  TOOL_CATALOG,
+  TOOL_KEYS,
+  describeCatalogTool,
+  findCatalogGroup,
+  findCatalogTool,
+  isToolKey,
+  tallyUsageKinds,
+  formatFilename,
+  decodeEntities,
+  escapeHtml,
+  parseOpenXmlProps,
+  stripBase64Images,
+  sanitizeMetadataString,
+  serializeMetadataValue,
+  chunkText,
+  splitRecursive,
+  buildHeader,
+  prepareChunks,
+  isEmbeddableMimeType,
+  l2Normalize,
+  sleep,
+  isRateLimitError,
+  withRateLimitRetry,
+  processQueueBatch,
+  getToolStatusMessage,
+  resolveDebounceMs,
+  channelBufferKey,
+  joinBufferedMessages,
+  isResourceSourceEnabled,
+  isDownloadableSource,
+  safeHostname,
+  buildResourceDownloadUrl,
+  formatSourcesAsMarkdown,
+  formatSourcesAsButtons,
+  refreshOAuthToken,
+  OAuthReauthRequiredError,
+  buildReauthMetadata,
+  clearReauthMetadata,
+  isCredentialNeedingReauth,
+  PlanLimitError,
+  isPlanLimitError
+};
+export type {
+  CustomCodeProject,
+  ProjectPathIssue,
+  CatalogGroup,
+  CatalogTool,
+  CatalogToolDescriptor,
+  ToolGroupKey,
+  ToolKey,
+  CalendarConfigField,
+  JsonSchema,
+  SchemaViolation,
+  MimeAttachment,
+  MimeMessageInput,
+  GmailOperation,
+  GmailSendRequest,
+  GmailSendResponse,
+  OutlookOperation,
+  OutlookSendRequest,
+  OutlookSendResponse,
+  SlackOperation,
+  SlackSendRequest,
+  SlackSendResponse,
+  SlackSendRemoteResourceRequest,
+  TelegramSendRequest,
+  TelegramSendResponse,
+  TelegramSendRemoteResourceRequest,
+  DiscordSendRequest,
+  DiscordSendResponse,
+  DiscordSendRemoteResourceRequest,
+  WhatsappSendRequest,
+  WhatsappSendResponse,
+  WhatsappSendRemoteResourceRequest,
+  EnvSource,
+  Separator,
+  ChunkMetadata,
+  PreparedChunk,
+  ExtractedDocument,
+  ExtractedDocumentMetadata,
+  ExtractedDocumentSource,
+  RateLimitRetryOptions,
+  QueueBatchLike,
+  QueueMessageLike,
+  ProcessQueueBatchHandlers,
+  ChannelNotifier,
+  ToolStatusEvent,
+  BufferedChannelMessage,
+  ChannelBufferEnvelope,
+  ChannelBufferFlush,
+  Source,
+  ResourceUrlContext,
+  SourceButton,
+  RefreshOAuthTokenInput,
+  RefreshedOAuthToken,
+  HttpEndpointToolConfig,
+  McpProxyToolConfig,
+  McpProxyDiscoveredTool,
+  McpProxyDiscoveredResource,
+  McpProxyDiscoveredPrompt,
+  McpProxyDiscovery,
+  CustomCodeToolConfig,
+  CustomCodeToolManifest,
+  CustomCodeManifest,
+  CustomCodeSendFile,
+  CustomCodeCreateResource,
+  CustomCodeTokenPayload,
+  OAuthProviderConfig,
+  AttachmentResource,
+  ResolvedAttachment,
+  ResolveAttachmentResult,
+  ExposableResource,
+  PlanLimitDetails,
+  PlanLimits
+};