@hybrd/utils 1.0.10 → 1.1.1

package/.turbo/turbo-build.log

@@ -1,5 +1,23 @@
 
 
-> @hybrd/utils@1.0.10 build /Users/ian/Projects/01/hybrid/packages/utils
-> tsc
+> @hybrd/utils@1.1.1 build /Users/ian/Projects/01/hybrid/packages/utils
+> tsup
 
+CLI Building entry: {"index":"src/index.ts"}
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.0
+CLI Using tsup config: /Users/ian/Projects/01/hybrid/packages/utils/tsup.config.ts
+CLI Target: es2020
+CLI Cleaning output folder
+CJS Build start
+ESM Build start
+ESM dist/index.js     5.11 KB
+ESM dist/index.js.map 13.61 KB
+ESM ⚡️ Build success in 19ms
+CJS dist/index.cjs     7.59 KB
+CJS dist/index.cjs.map 14.07 KB
+CJS ⚡️ Build success in 19ms
+DTS Build start
+DTS ⚡️ Build success in 924ms
+DTS dist/index.d.cts 5.76 KB
+DTS dist/index.d.ts  5.76 KB

package/dist/index.cjs

@@ -0,0 +1,261 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  ExternalDatabaseAdapter: () => ExternalDatabaseAdapter,
+  R2StorageAdapter: () => R2StorageAdapter,
+  chunk: () => chunk,
+  createStorageAdapter: () => createStorageAdapter,
+  formatDate: () => formatDate,
+  formatRelativeDate: () => formatRelativeDate,
+  getCloudflareEnvironment: () => getCloudflareEnvironment,
+  getCloudflareServiceUrl: () => getCloudflareServiceUrl,
+  getCloudflareStoragePath: () => getCloudflareStoragePath,
+  getUrl: () => getUrl,
+  pruneEmpty: () => pruneEmpty,
+  randomUUID: () => randomUUID,
+  shuffle: () => shuffle,
+  stringifyValues: () => stringifyValues,
+  stripMarkdown: () => stripMarkdown,
+  truncate: () => truncate,
+  uniq: () => uniq
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/lib/array.ts
+function chunk(arr, size) {
+  return Array.from(
+    { length: Math.ceil(arr.length / size) },
+    (_, i) => arr.slice(i * size, i * size + size)
+  );
+}
+function uniq(array) {
+  return array.filter((item, index, self) => self.indexOf(item) === index);
+}
+function shuffle(array) {
+  if (!array) return [];
+  return array.sort(() => Math.random() - 0.5);
+}
+
+// src/lib/cloudflare.ts
+function getCloudflareEnvironment() {
+  if (process.env.CF_PAGES_BRANCH) {
+    return {
+      isCloudflare: true,
+      platform: "pages",
+      storagePath: "/tmp"
+    };
+  }
+  if (process.env.CF_WORKER_NAME) {
+    return {
+      isCloudflare: true,
+      platform: "workers",
+      storagePath: "/tmp"
+    };
+  }
+  return {
+    isCloudflare: false,
+    platform: "local",
+    storagePath: process.env.PROJECT_ROOT || process.cwd()
+  };
+}
+function getCloudflareStoragePath(subPath) {
+  const env = getCloudflareEnvironment();
+  if (env.isCloudflare) {
+    return subPath ? `/tmp/${subPath}` : "/tmp";
+  }
+  const basePath = env.storagePath;
+  const dataPath = subPath ? `${basePath}/.data/${subPath}` : `${basePath}/.data`;
+  return dataPath;
+}
+function getCloudflareServiceUrl(fallbackPort = 3e3) {
+  if (process.env.CF_PAGES_URL) {
+    return process.env.CF_PAGES_URL;
+  }
+  if (process.env.CF_WORKER_URL) {
+    return process.env.CF_WORKER_URL;
+  }
+  return `http://localhost:${fallbackPort}`;
+}
+
+// src/lib/storage.ts
+var import_promises = __toESM(require("fs/promises"), 1);
+var R2StorageAdapter = class {
+  constructor(bucket) {
+    this.bucket = bucket;
+  }
+  async uploadFile(localPath, remotePath) {
+    const fileData = await import_promises.default.readFile(localPath);
+    await this.bucket.put(remotePath, fileData);
+  }
+  async downloadFile(remotePath, localPath) {
+    const object = await this.bucket.get(remotePath);
+    if (object) {
+      await import_promises.default.writeFile(localPath, await object.arrayBuffer());
+    }
+  }
+  async exists(remotePath) {
+    const object = await this.bucket.head(remotePath);
+    return object !== null;
+  }
+  async delete(remotePath) {
+    await this.bucket.delete(remotePath);
+  }
+};
+var ExternalDatabaseAdapter = class {
+  constructor(connectionString) {
+    this.connectionString = connectionString;
+  }
+  async uploadFile(localPath, remotePath) {
+    throw new Error("External database storage not yet implemented");
+  }
+  async downloadFile(remotePath, localPath) {
+    throw new Error("External database storage not yet implemented");
+  }
+  async exists(remotePath) {
+    return false;
+  }
+  async delete(remotePath) {
+  }
+};
+function createStorageAdapter() {
+  if (typeof globalThis !== "undefined" && "XMTP_STORAGE" in globalThis) {
+    return new R2StorageAdapter(globalThis.XMTP_STORAGE);
+  }
+  if (typeof process !== "undefined" && process.env?.DATABASE_URL) {
+    return new ExternalDatabaseAdapter(process.env.DATABASE_URL);
+  }
+  return null;
+}
+
+// src/lib/date.ts
+var import_date_fns = require("date-fns");
+function formatDate(stringOrDate) {
+  if (!stringOrDate) return "";
+  const date = new Date(stringOrDate);
+  return date.toLocaleDateString(void 0, {
+    year: "numeric",
+    month: "short",
+    day: "numeric"
+  });
+}
+function formatRelativeDate(date) {
+  if ((0, import_date_fns.isToday)(date)) {
+    return `Today, ${(0, import_date_fns.format)(date, "h:mm a")}`;
+  }
+  if ((0, import_date_fns.isYesterday)(date)) {
+    return `Yesterday, ${(0, import_date_fns.format)(date, "h:mm a")}`;
+  }
+  if ((/* @__PURE__ */ new Date()).getFullYear() === date.getFullYear()) {
+    return (0, import_date_fns.format)(date, "MMM d, h:mm a");
+  }
+  return (0, import_date_fns.format)(date, "MMM d, yyyy");
+}
+
+// src/lib/object.ts
+function stringifyValues(obj) {
+  const result = {};
+  if (!obj) {
+    return {};
+  }
+  for (const key in obj) {
+    const value = obj[key];
+    result[key] = value === null ? "null" : typeof value === "object" ? JSON.stringify(value) : String(value);
+  }
+  return result;
+}
+function pruneEmpty(obj) {
+  if (!obj) {
+    return {};
+  }
+  return Object.entries(obj).reduce(
+    (acc, [key, value]) => {
+      if (value === void 0 || value === null || value === "") {
+        return acc;
+      }
+      acc[key] = value;
+      return acc;
+    },
+    {}
+  );
+}
+
+// src/lib/markdown.ts
+var import_remark = require("remark");
+var import_strip_markdown = __toESM(require("strip-markdown"), 1);
+async function stripMarkdown(markdown) {
+  const file = await (0, import_remark.remark)().use(import_strip_markdown.default).process(markdown);
+  return String(file);
+}
+
+// src/lib/string.ts
+function truncate(str, length) {
+  return str.length > length ? `${str.slice(0, length)}...` : str;
+}
+
+// src/lib/urls.ts
+function getUrl(path = "") {
+  const trimmedPath = path.replace(/^\/+/, "");
+  if (process.env.AGENT_URL) {
+    return `https://${process.env.AGENT_URL}/${trimmedPath}`;
+  }
+  if (process.env.RAILWAY_PUBLIC_DOMAIN) {
+    return `https://${process.env.RAILWAY_PUBLIC_DOMAIN}/${trimmedPath}`;
+  }
+  return `https://localhost:8454/${trimmedPath}`;
+}
+
+// src/lib/uuid.ts
+var import_uuid = require("uuid");
+function randomUUID() {
+  return (0, import_uuid.v4)();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExternalDatabaseAdapter,
+  R2StorageAdapter,
+  chunk,
+  createStorageAdapter,
+  formatDate,
+  formatRelativeDate,
+  getCloudflareEnvironment,
+  getCloudflareServiceUrl,
+  getCloudflareStoragePath,
+  getUrl,
+  pruneEmpty,
+  randomUUID,
+  shuffle,
+  stringifyValues,
+  stripMarkdown,
+  truncate,
+  uniq
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/lib/array.ts","../src/lib/cloudflare.ts","../src/lib/storage.ts","../src/lib/date.ts","../src/lib/object.ts","../src/lib/markdown.ts","../src/lib/string.ts","../src/lib/urls.ts","../src/lib/uuid.ts"],"sourcesContent":["export * from \"./lib/array\"\nexport * from \"./lib/cloudflare\"\nexport * from \"./lib/storage\"\nexport * from \"./lib/date\"\nexport * from \"./lib/object\"\nexport * from \"./lib/markdown\"\nexport * from \"./lib/string\"\nexport * from \"./lib/urls\"\nexport * from \"./lib/uuid\"\n","/**\n * Splits an array into chunks of specified size.\n *\n * @template T - The type of the array elements.\n * @param {T[]} arr - The array to split into chunks.\n * @param {number} size - The maximum number of elements per chunk.\n * @returns {T[][]} An array of chunks, where each chunk is an array of T.\n */\nexport function chunk<T>(arr: T[], size: number): T[][] {\n\treturn Array.from({ length: Math.ceil(arr.length / size) }, (_, i) =>\n\t\tarr.slice(i * size, i * size + size)\n\t)\n}\n\n/**\n * Returns a new array with only unique elements from the input array.\n *\n * @template T - The type of the array elements.\n * @param {T[]} array - The array from which to remove duplicate elements.\n * @returns {T[]} A new array containing only unique elements.\n */\nexport function uniq<T>(array: T[]): T[] {\n\treturn array.filter((item, index, self) => self.indexOf(item) === index)\n}\n\n/**\n * Randomly shuffles the elements of an array.\n *\n * @param {any[] | undefined} array - The array to shuffle. If undefined, returns an empty array.\n * @returns {any[]} A shuffled copy of the input array.\n */\nexport function shuffle(array: any[] | undefined) {\n\tif (!array) return []\n\treturn array.sort(() => Math.random() - 0.5)\n}\n","/**\n * Cloudflare environment detection and storage utilities\n */\n\ndeclare const process: {\n  env: Record<string, string | undefined>\n  cwd(): string\n}\n\nexport interface CloudflareEnvironment {\n  isCloudflare: boolean\n  platform: 'pages' | 'workers' | 'local'\n  storagePath: string\n}\n\n/**\n * Detects if running in Cloudflare environment and returns appropriate storage configuration\n */\nexport function getCloudflareEnvironment(): CloudflareEnvironment {\n  if (process.env.CF_PAGES_BRANCH) {\n    return {\n      isCloudflare: true,\n      platform: 'pages',\n      storagePath: '/tmp'\n    }\n  }\n\n  if (process.env.CF_WORKER_NAME) {\n    return {\n      isCloudflare: true,\n      platform: 'workers',\n      storagePath: '/tmp'\n    }\n  }\n\n  return {\n    isCloudflare: false,\n    platform: 'local',\n    storagePath: process.env.PROJECT_ROOT || process.cwd()\n  }\n}\n\n/**\n * Gets the appropriate storage path for the current environment\n * @param subPath - Optional subdirectory within the storage path\n */\nexport function getCloudflareStoragePath(subPath?: string): string {\n  const env = getCloudflareEnvironment()\n  \n  if (env.isCloudflare) {\n    return subPath ? `/tmp/${subPath}` : '/tmp'\n  }\n\n  const basePath = env.storagePath\n  const dataPath = subPath ? `${basePath}/.data/${subPath}` : `${basePath}/.data`\n  \n  return dataPath\n}\n\n/**\n * Gets service URL based on Cloudflare environment variables\n */\nexport function getCloudflareServiceUrl(fallbackPort = 3000): string {\n  if (process.env.CF_PAGES_URL) {\n    return process.env.CF_PAGES_URL\n  }\n\n  if (process.env.CF_WORKER_URL) {\n    return process.env.CF_WORKER_URL\n  }\n\n  // Local development fallback\n  return `http://localhost:${fallbackPort}`\n}\n","import fs from \"node:fs/promises\"\n\nexport interface StorageAdapter {\n  uploadFile(localPath: string, remotePath: string): Promise<void>\n  downloadFile(remotePath: string, localPath: string): Promise<void>\n  exists(remotePath: string): Promise<boolean>\n  delete(remotePath: string): Promise<void>\n}\n\nexport class R2StorageAdapter implements StorageAdapter {\n  constructor(private bucket: any) {}\n  \n  async uploadFile(localPath: string, remotePath: string): Promise<void> {\n    const fileData = await fs.readFile(localPath)\n    await this.bucket.put(remotePath, fileData)\n  }\n  \n  async downloadFile(remotePath: string, localPath: string): Promise<void> {\n    const object = await this.bucket.get(remotePath)\n    if (object) {\n      await fs.writeFile(localPath, await object.arrayBuffer())\n    }\n  }\n  \n  async exists(remotePath: string): Promise<boolean> {\n    const object = await this.bucket.head(remotePath)\n    return object !== null\n  }\n  \n  async delete(remotePath: string): Promise<void> {\n    await this.bucket.delete(remotePath)\n  }\n}\n\nexport class ExternalDatabaseAdapter implements StorageAdapter {\n  constructor(private connectionString: string) {}\n  \n  async uploadFile(localPath: string, remotePath: string): Promise<void> {\n    throw new Error('External database storage not yet implemented')\n  }\n  \n  async downloadFile(remotePath: string, localPath: string): Promise<void> {\n    throw new Error('External database storage not yet implemented')\n  }\n  \n  async exists(remotePath: string): Promise<boolean> {\n    return false\n  }\n  \n  async delete(remotePath: string): Promise<void> {\n  }\n}\n\nexport function createStorageAdapter(): StorageAdapter | null {\n  if (typeof globalThis !== 'undefined' && 'XMTP_STORAGE' in globalThis) {\n    return new R2StorageAdapter((globalThis as any).XMTP_STORAGE)\n  }\n  \n  if (typeof process !== 'undefined' && process.env?.DATABASE_URL) {\n    return new ExternalDatabaseAdapter(process.env.DATABASE_URL)\n  }\n  \n  return null\n}\n","import { format, isToday, isYesterday } from \"date-fns\";\n\n/**\n * Formats a date string or Date object into a localized date string\n * @param stringOrDate - Date string or Date object to format\n * @returns Formatted date string (e.g., \"Jan 1, 2024\") or empty string if no input\n */\nexport function formatDate(stringOrDate?: string | Date): string {\n\tif (!stringOrDate) return \"\";\n\n\tconst date = new Date(stringOrDate);\n\n\treturn date.toLocaleDateString(undefined, {\n\t\tyear: \"numeric\",\n\t\tmonth: \"short\",\n\t\tday: \"numeric\",\n\t});\n}\n\n/**\n * Formats a date relative to the current time\n * @param date - Date object to format\n * @returns Formatted string with relative time:\n * - \"Today, [time]\" for today's dates\n * - \"Yesterday, [time]\" for yesterday's dates\n * - \"MMM d, h:mm a\" for dates in current year\n * - \"MMM d, yyyy\" for dates in other years\n */\nexport function formatRelativeDate(date: Date) {\n\tif (isToday(date)) {\n\t\treturn `Today, ${format(date, \"h:mm a\")}`;\n\t}\n\tif (isYesterday(date)) {\n\t\treturn `Yesterday, ${format(date, \"h:mm a\")}`;\n\t}\n\tif (new Date().getFullYear() === date.getFullYear()) {\n\t\treturn format(date, \"MMM d, h:mm a\");\n\t}\n\treturn format(date, \"MMM d, yyyy\");\n}\n","/**\n * Stringifies all values in an object, including objects and null values.\n * If obj is undefined, returns an empty object.\n * @param obj - The object to stringify\n * @returns A new object with the same keys as obj, but with all values stringified\n */\nexport function stringifyValues(\n\tobj: Record<string, unknown> | undefined\n): Record<string, string> {\n\tconst result: Record<string, string> = {}\n\n\tif (!obj) {\n\t\treturn {}\n\t}\n\n\tfor (const key in obj) {\n\t\tconst value = obj[key]\n\t\tresult[key] =\n\t\t\tvalue === null\n\t\t\t\t? \"null\"\n\t\t\t\t: typeof value === \"object\"\n\t\t\t\t\t? JSON.stringify(value)\n\t\t\t\t\t: String(value)\n\t}\n\n\treturn result\n}\n\n/**\n * Removes empty values (undefined, null, empty strings) from an object\n *\n * @param obj - The object to prune\n * @returns A new object with empty values removed\n */\nexport function pruneEmpty<T extends Record<string, unknown>>(\n\tobj: T | undefined\n): Partial<T> {\n\tif (!obj) {\n\t\treturn {}\n\t}\n\n\treturn Object.entries(obj).reduce(\n\t\t(acc, [key, value]) => {\n\t\t\t// Skip undefined, null, and empty strings\n\t\t\tif (value === undefined || value === null || value === \"\") {\n\t\t\t\treturn acc\n\t\t\t}\n\t\t\t// Avoid spread syntax on accumulator\n\t\t\tacc[key as keyof T] = value as any\n\t\t\treturn acc\n\t\t},\n\t\t{} as Partial<T>\n\t)\n}\n","import { remark } from \"remark\"\nimport strip from \"strip-markdown\"\n\n/**\n * Strips markdown from a string\n * @param markdown - The markdown string to strip\n * @returns The stripped markdown string\n */\nexport async function stripMarkdown(markdown: string) {\n\tconst file = await remark().use(strip).process(markdown)\n\treturn String(file)\n}\n","/**\n * Truncates a given string to a specified length, adding an ellipsis if the\n * string is longer than the specified length.\n *\n * @param {string} str - The string to truncate.\n * @param {number} length - The maximum length of the resulting string.\n *\n * @returns {string} The truncated string.\n */\nexport function truncate(str: string, length: number) {\n\treturn str.length > length ? `${str.slice(0, length)}...` : str\n}\n","/**\n * Get the agent application URL for webhooks and callbacks\n *\n * This function constructs the URL for the main agent application, used primarily\n * for QStash webhooks and external callbacks. It supports multiple deployment\n * environments with fallback logic.\n *\n * @param path - Optional path to append to the base URL (leading slashes are normalized)\n * @returns The complete URL for the agent application\n *\n * @example\n * ```typescript\n * // Get base URL\n * getUrl() // \"http://localhost:8454/\"\n *\n * // Get URL with path\n * getUrl(\"/qstash/webhook\") // \"http://localhost:8454/qstash/webhook\"\n * getUrl(\"api/health\") // \"http://localhost:8454/api/health\"\n * ```\n *\n * @remarks\n * URL resolution priority:\n * 1. `AGENT_URL` environment variable (custom deployment)\n * 2. `RAILWAY_PUBLIC_DOMAIN` environment variable (Railway deployment)\n * 3. `http://localhost:8454/` (default)\n */\nexport function getUrl(path = \"\") {\n\tconst trimmedPath = path.replace(/^\\/+/, \"\")\n\n\tif (process.env.AGENT_URL) {\n\t\treturn `https://${process.env.AGENT_URL}/${trimmedPath}`\n\t}\n\n\tif (process.env.RAILWAY_PUBLIC_DOMAIN) {\n\t\treturn `https://${process.env.RAILWAY_PUBLIC_DOMAIN}/${trimmedPath}`\n\t}\n\n\treturn `https://localhost:8454/${trimmedPath}`\n}\n","import { v4 as uuidv4 } from \"uuid\";\n\n// The node:crypto version is not supported in the browser.\n// Use the uuid package instead.\nexport function randomUUID(): string {\n\treturn uuidv4();\n}\n"],"mappings":"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","names":["fs","strip","uuidv4"]}

package/dist/index.d.cts

@@ -0,0 +1,152 @@
+/**
+ * Splits an array into chunks of specified size.
+ *
+ * @template T - The type of the array elements.
+ * @param {T[]} arr - The array to split into chunks.
+ * @param {number} size - The maximum number of elements per chunk.
+ * @returns {T[][]} An array of chunks, where each chunk is an array of T.
+ */
+declare function chunk<T>(arr: T[], size: number): T[][];
+/**
+ * Returns a new array with only unique elements from the input array.
+ *
+ * @template T - The type of the array elements.
+ * @param {T[]} array - The array from which to remove duplicate elements.
+ * @returns {T[]} A new array containing only unique elements.
+ */
+declare function uniq<T>(array: T[]): T[];
+/**
+ * Randomly shuffles the elements of an array.
+ *
+ * @param {any[] | undefined} array - The array to shuffle. If undefined, returns an empty array.
+ * @returns {any[]} A shuffled copy of the input array.
+ */
+declare function shuffle(array: any[] | undefined): any[];
+
+/**
+ * Cloudflare environment detection and storage utilities
+ */
+interface CloudflareEnvironment {
+    isCloudflare: boolean;
+    platform: 'pages' | 'workers' | 'local';
+    storagePath: string;
+}
+/**
+ * Detects if running in Cloudflare environment and returns appropriate storage configuration
+ */
+declare function getCloudflareEnvironment(): CloudflareEnvironment;
+/**
+ * Gets the appropriate storage path for the current environment
+ * @param subPath - Optional subdirectory within the storage path
+ */
+declare function getCloudflareStoragePath(subPath?: string): string;
+/**
+ * Gets service URL based on Cloudflare environment variables
+ */
+declare function getCloudflareServiceUrl(fallbackPort?: number): string;
+
+interface StorageAdapter {
+    uploadFile(localPath: string, remotePath: string): Promise<void>;
+    downloadFile(remotePath: string, localPath: string): Promise<void>;
+    exists(remotePath: string): Promise<boolean>;
+    delete(remotePath: string): Promise<void>;
+}
+declare class R2StorageAdapter implements StorageAdapter {
+    private bucket;
+    constructor(bucket: any);
+    uploadFile(localPath: string, remotePath: string): Promise<void>;
+    downloadFile(remotePath: string, localPath: string): Promise<void>;
+    exists(remotePath: string): Promise<boolean>;
+    delete(remotePath: string): Promise<void>;
+}
+declare class ExternalDatabaseAdapter implements StorageAdapter {
+    private connectionString;
+    constructor(connectionString: string);
+    uploadFile(localPath: string, remotePath: string): Promise<void>;
+    downloadFile(remotePath: string, localPath: string): Promise<void>;
+    exists(remotePath: string): Promise<boolean>;
+    delete(remotePath: string): Promise<void>;
+}
+declare function createStorageAdapter(): StorageAdapter | null;
+
+/**
+ * Formats a date string or Date object into a localized date string
+ * @param stringOrDate - Date string or Date object to format
+ * @returns Formatted date string (e.g., "Jan 1, 2024") or empty string if no input
+ */
+declare function formatDate(stringOrDate?: string | Date): string;
+/**
+ * Formats a date relative to the current time
+ * @param date - Date object to format
+ * @returns Formatted string with relative time:
+ * - "Today, [time]" for today's dates
+ * - "Yesterday, [time]" for yesterday's dates
+ * - "MMM d, h:mm a" for dates in current year
+ * - "MMM d, yyyy" for dates in other years
+ */
+declare function formatRelativeDate(date: Date): string;
+
+/**
+ * Stringifies all values in an object, including objects and null values.
+ * If obj is undefined, returns an empty object.
+ * @param obj - The object to stringify
+ * @returns A new object with the same keys as obj, but with all values stringified
+ */
+declare function stringifyValues(obj: Record<string, unknown> | undefined): Record<string, string>;
+/**
+ * Removes empty values (undefined, null, empty strings) from an object
+ *
+ * @param obj - The object to prune
+ * @returns A new object with empty values removed
+ */
+declare function pruneEmpty<T extends Record<string, unknown>>(obj: T | undefined): Partial<T>;
+
+/**
+ * Strips markdown from a string
+ * @param markdown - The markdown string to strip
+ * @returns The stripped markdown string
+ */
+declare function stripMarkdown(markdown: string): Promise<string>;
+
+/**
+ * Truncates a given string to a specified length, adding an ellipsis if the
+ * string is longer than the specified length.
+ *
+ * @param {string} str - The string to truncate.
+ * @param {number} length - The maximum length of the resulting string.
+ *
+ * @returns {string} The truncated string.
+ */
+declare function truncate(str: string, length: number): string;
+
+/**
+ * Get the agent application URL for webhooks and callbacks
+ *
+ * This function constructs the URL for the main agent application, used primarily
+ * for QStash webhooks and external callbacks. It supports multiple deployment
+ * environments with fallback logic.
+ *
+ * @param path - Optional path to append to the base URL (leading slashes are normalized)
+ * @returns The complete URL for the agent application
+ *
+ * @example
+ * ```typescript
+ * // Get base URL
+ * getUrl() // "http://localhost:8454/"
+ *
+ * // Get URL with path
+ * getUrl("/qstash/webhook") // "http://localhost:8454/qstash/webhook"
+ * getUrl("api/health") // "http://localhost:8454/api/health"
+ * ```
+ *
+ * @remarks
+ * URL resolution priority:
+ * 1. `AGENT_URL` environment variable (custom deployment)
+ * 2. `RAILWAY_PUBLIC_DOMAIN` environment variable (Railway deployment)
+ * 3. `http://localhost:8454/` (default)
+ */
+declare function getUrl(path?: string): string;
+
+declare function randomUUID(): string;
+
+export { type CloudflareEnvironment, ExternalDatabaseAdapter, R2StorageAdapter, type StorageAdapter, chunk, createStorageAdapter, formatDate, formatRelativeDate, getCloudflareEnvironment, getCloudflareServiceUrl, getCloudflareStoragePath, getUrl, pruneEmpty, randomUUID, shuffle, stringifyValues, stripMarkdown, truncate, uniq };

package/dist/index.d.ts

@@ -1,10 +1,152 @@
-export * from "./lib/array";
-export * from "./lib/cloudflare";
-export * from "./lib/storage";
-export * from "./lib/date";
-export * from "./lib/object";
-export * from "./lib/markdown";
-export * from "./lib/string";
-export * from "./lib/urls";
-export * from "./lib/uuid";
-//# sourceMappingURL=index.d.ts.map
+/**
+ * Splits an array into chunks of specified size.
+ *
+ * @template T - The type of the array elements.
+ * @param {T[]} arr - The array to split into chunks.
+ * @param {number} size - The maximum number of elements per chunk.
+ * @returns {T[][]} An array of chunks, where each chunk is an array of T.
+ */
+declare function chunk<T>(arr: T[], size: number): T[][];
+/**
+ * Returns a new array with only unique elements from the input array.
+ *
+ * @template T - The type of the array elements.
+ * @param {T[]} array - The array from which to remove duplicate elements.
+ * @returns {T[]} A new array containing only unique elements.
+ */
+declare function uniq<T>(array: T[]): T[];
+/**
+ * Randomly shuffles the elements of an array.
+ *
+ * @param {any[] | undefined} array - The array to shuffle. If undefined, returns an empty array.
+ * @returns {any[]} A shuffled copy of the input array.
+ */
+declare function shuffle(array: any[] | undefined): any[];
+
+/**
+ * Cloudflare environment detection and storage utilities
+ */
+interface CloudflareEnvironment {
+    isCloudflare: boolean;
+    platform: 'pages' | 'workers' | 'local';
+    storagePath: string;
+}
+/**
+ * Detects if running in Cloudflare environment and returns appropriate storage configuration
+ */
+declare function getCloudflareEnvironment(): CloudflareEnvironment;
+/**
+ * Gets the appropriate storage path for the current environment
+ * @param subPath - Optional subdirectory within the storage path
+ */
+declare function getCloudflareStoragePath(subPath?: string): string;
+/**
+ * Gets service URL based on Cloudflare environment variables
+ */
+declare function getCloudflareServiceUrl(fallbackPort?: number): string;
+
+interface StorageAdapter {
+    uploadFile(localPath: string, remotePath: string): Promise<void>;
+    downloadFile(remotePath: string, localPath: string): Promise<void>;
+    exists(remotePath: string): Promise<boolean>;
+    delete(remotePath: string): Promise<void>;
+}
+declare class R2StorageAdapter implements StorageAdapter {
+    private bucket;
+    constructor(bucket: any);
+    uploadFile(localPath: string, remotePath: string): Promise<void>;
+    downloadFile(remotePath: string, localPath: string): Promise<void>;
+    exists(remotePath: string): Promise<boolean>;
+    delete(remotePath: string): Promise<void>;
+}
+declare class ExternalDatabaseAdapter implements StorageAdapter {
+    private connectionString;
+    constructor(connectionString: string);
+    uploadFile(localPath: string, remotePath: string): Promise<void>;
+    downloadFile(remotePath: string, localPath: string): Promise<void>;
+    exists(remotePath: string): Promise<boolean>;
+    delete(remotePath: string): Promise<void>;
+}
+declare function createStorageAdapter(): StorageAdapter | null;
+
+/**
+ * Formats a date string or Date object into a localized date string
+ * @param stringOrDate - Date string or Date object to format
+ * @returns Formatted date string (e.g., "Jan 1, 2024") or empty string if no input
+ */
+declare function formatDate(stringOrDate?: string | Date): string;
+/**
+ * Formats a date relative to the current time
+ * @param date - Date object to format
+ * @returns Formatted string with relative time:
+ * - "Today, [time]" for today's dates
+ * - "Yesterday, [time]" for yesterday's dates
+ * - "MMM d, h:mm a" for dates in current year
+ * - "MMM d, yyyy" for dates in other years
+ */
+declare function formatRelativeDate(date: Date): string;
+
+/**
+ * Stringifies all values in an object, including objects and null values.
+ * If obj is undefined, returns an empty object.
+ * @param obj - The object to stringify
+ * @returns A new object with the same keys as obj, but with all values stringified
+ */
+declare function stringifyValues(obj: Record<string, unknown> | undefined): Record<string, string>;
+/**
+ * Removes empty values (undefined, null, empty strings) from an object
+ *
+ * @param obj - The object to prune
+ * @returns A new object with empty values removed
+ */
+declare function pruneEmpty<T extends Record<string, unknown>>(obj: T | undefined): Partial<T>;
+
+/**
+ * Strips markdown from a string
+ * @param markdown - The markdown string to strip
+ * @returns The stripped markdown string
+ */
+declare function stripMarkdown(markdown: string): Promise<string>;
+
+/**
+ * Truncates a given string to a specified length, adding an ellipsis if the
+ * string is longer than the specified length.
+ *
+ * @param {string} str - The string to truncate.
+ * @param {number} length - The maximum length of the resulting string.
+ *
+ * @returns {string} The truncated string.
+ */
+declare function truncate(str: string, length: number): string;
+
+/**
+ * Get the agent application URL for webhooks and callbacks
+ *
+ * This function constructs the URL for the main agent application, used primarily
+ * for QStash webhooks and external callbacks. It supports multiple deployment
+ * environments with fallback logic.
+ *
+ * @param path - Optional path to append to the base URL (leading slashes are normalized)
+ * @returns The complete URL for the agent application
+ *
+ * @example
+ * ```typescript
+ * // Get base URL
+ * getUrl() // "http://localhost:8454/"
+ *
+ * // Get URL with path
+ * getUrl("/qstash/webhook") // "http://localhost:8454/qstash/webhook"
+ * getUrl("api/health") // "http://localhost:8454/api/health"
+ * ```
+ *
+ * @remarks
+ * URL resolution priority:
+ * 1. `AGENT_URL` environment variable (custom deployment)
+ * 2. `RAILWAY_PUBLIC_DOMAIN` environment variable (Railway deployment)
+ * 3. `http://localhost:8454/` (default)
+ */
+declare function getUrl(path?: string): string;
+
+declare function randomUUID(): string;
+
+export { type CloudflareEnvironment, ExternalDatabaseAdapter, R2StorageAdapter, type StorageAdapter, chunk, createStorageAdapter, formatDate, formatRelativeDate, getCloudflareEnvironment, getCloudflareServiceUrl, getCloudflareStoragePath, getUrl, pruneEmpty, randomUUID, shuffle, stringifyValues, stripMarkdown, truncate, uniq };