@hybrd/utils 1.0.8 → 1.1.0

package/dist/index.js

@@ -1,9 +1,208 @@
-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";
+// 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
+import fs from "fs/promises";
+var R2StorageAdapter = class {
+  constructor(bucket) {
+    this.bucket = bucket;
+  }
+  async uploadFile(localPath, remotePath) {
+    const fileData = await fs.readFile(localPath);
+    await this.bucket.put(remotePath, fileData);
+  }
+  async downloadFile(remotePath, localPath) {
+    const object = await this.bucket.get(remotePath);
+    if (object) {
+      await fs.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
+import { format, isToday, isYesterday } from "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 (isToday(date)) {
+    return `Today, ${format(date, "h:mm a")}`;
+  }
+  if (isYesterday(date)) {
+    return `Yesterday, ${format(date, "h:mm a")}`;
+  }
+  if ((/* @__PURE__ */ new Date()).getFullYear() === date.getFullYear()) {
+    return format(date, "MMM d, h:mm a");
+  }
+  return 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
+import { remark } from "remark";
+import strip from "strip-markdown";
+async function stripMarkdown(markdown) {
+  const file = await remark().use(strip).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
+import { v4 as uuidv4 } from "uuid";
+function randomUUID() {
+  return uuidv4();
+}
+export {
+  ExternalDatabaseAdapter,
+  R2StorageAdapter,
+  chunk,
+  createStorageAdapter,
+  formatDate,
+  formatRelativeDate,
+  getCloudflareEnvironment,
+  getCloudflareServiceUrl,
+  getCloudflareStoragePath,
+  getUrl,
+  pruneEmpty,
+  randomUUID,
+  shuffle,
+  stringifyValues,
+  stripMarkdown,
+  truncate,
+  uniq
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../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":["/**\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":[]}

package/package.json

@@ -1,30 +1,32 @@
 {
-	"name": "@hybrd/utils",
-	"version": "1.0.8",
-	"type": "module",
-	"exports": {
-		".": {
-			"import": "./dist/index.js",
-			"types": "./dist/index.d.ts"
-		}
-	},
-	"scripts": {
-		"build": "tsc",
-		"clean": "rm -rf .turbo dist",
-		"lint": "biome lint --unsafe",
-		"lint:fix": "biome lint --write --unsafe",
-		"typecheck": "tsc --noEmit"
-	},
-	"dependencies": {
-		"date-fns": "4.1.0",
-		"mime": "^4.0.7",
-		"remark": "^15.0.1",
-		"strip-markdown": "^6.0.0",
-		"uuid": "11.0.5"
-	},
-	"devDependencies": {
-		"@hybrd/biome": "workspace:*",
-		"@hybrd/tsconfig": "workspace:*",
-		"@types/node": "catalog:stack"
-	}
-}
+  "name": "@hybrd/utils",
+  "version": "1.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "dependencies": {
+    "date-fns": "4.1.0",
+    "mime": "^4.0.7",
+    "remark": "^15.0.1",
+    "strip-markdown": "^6.0.0",
+    "uuid": "11.0.5"
+  },
+  "devDependencies": {
+    "@types/node": "22.8.6",
+    "tsup": "^8.5.0",
+    "@config/tsconfig": "0.0.0",
+    "@config/biome": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf .turbo dist",
+    "lint": "biome lint --unsafe",
+    "lint:fix": "biome lint --write --unsafe",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/tsconfig.json

@@ -1,9 +1,13 @@
 {
-	"extends": "@hybrd/tsconfig/internal-package.json",
+	"extends": "@config/tsconfig/external-package.json",
 	"compilerOptions": {
 		"emitDeclarationOnly": false,
-		"outDir": "dist"
+		"noEmit": false,
+		"outDir": "dist",
+		"module": "ES2020",
+		"moduleResolution": "node",
+		"target": "ES2020"
 	},
-	"include": ["src/**/*.ts", "src/**/*.tsx"],
-	"exclude": ["node_modules"]
+	"include": ["src/**/*.ts"],
+	"exclude": ["node_modules", "dist"]
 }

package/tsup.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from "tsup"
+
+export default defineConfig({
+	entry: {
+		index: "src/index.ts"
+	},
+	format: ["cjs", "esm"],
+	dts: true,
+	splitting: false,
+	sourcemap: true,
+	clean: true,
+	outDir: "dist",
+	target: "es2020"
+})

package/.turbo/turbo-lint$colon$fix.log

@@ -1,6 +0,0 @@
-
-
-> @hybrd/utils@1.0.2 lint:fix /Users/ian/Projects/01/hybrid/packages/utils
-> biome lint --write --unsafe
-
-Checked 12 files in 12ms. No fixes applied.

package/.turbo/turbo-lint.log

@@ -1,6 +0,0 @@
-
-
-> @repo/utils@ lint /Users/ian/Projects/01/cointoss/packages/utils
-> biome lint --unsafe
-
-Checked 10 files in 47ms. No fixes applied.

package/.turbo/turbo-typecheck.log

@@ -1,5 +0,0 @@
-
-
-> @hybrd/utils@1.0.0-alpha.1 typecheck /Users/ian/Projects/01/hybrid/packages/utils
-> tsc --noEmit
-

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/dist/lib/array.d.ts

@@ -1,25 +0,0 @@
-/**
- * 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.
- */
-export 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.
- */
-export 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.
- */
-export declare function shuffle(array: any[] | undefined): any[];
-//# sourceMappingURL=array.d.ts.map

package/dist/lib/array.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/lib/array.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAItD;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAEvC;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,SAAS,SAG/C"}

package/dist/lib/array.js

@@ -1,32 +0,0 @@
-/**
- * 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.
- */
-export function chunk(arr, size) {
-    return Array.from({ length: Math.ceil(arr.length / size) }, (_, i) => arr.slice(i * size, i * size + size));
-}
-/**
- * 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.
- */
-export function uniq(array) {
-    return array.filter((item, index, self) => self.indexOf(item) === index);
-}
-/**
- * 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.
- */
-export function shuffle(array) {
-    if (!array)
-        return [];
-    return array.sort(() => Math.random() - 0.5);
-}

package/dist/lib/cloudflare.d.ts

@@ -1,22 +0,0 @@
-/**
- * Cloudflare environment detection and storage utilities
- */
-export interface CloudflareEnvironment {
-    isCloudflare: boolean;
-    platform: 'pages' | 'workers' | 'local';
-    storagePath: string;
-}
-/**
- * Detects if running in Cloudflare environment and returns appropriate storage configuration
- */
-export declare function getCloudflareEnvironment(): CloudflareEnvironment;
-/**
- * Gets the appropriate storage path for the current environment
- * @param subPath - Optional subdirectory within the storage path
- */
-export declare function getCloudflareStoragePath(subPath?: string): string;
-/**
- * Gets service URL based on Cloudflare environment variables
- */
-export declare function getCloudflareServiceUrl(fallbackPort?: number): string;
-//# sourceMappingURL=cloudflare.d.ts.map

package/dist/lib/cloudflare.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../../src/lib/cloudflare.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,OAAO,CAAA;IACrB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAA;IACvC,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,qBAAqB,CAsBhE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAWjE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,SAAO,GAAG,MAAM,CAWnE"}

package/dist/lib/cloudflare.js

@@ -1,53 +0,0 @@
-/**
- * Cloudflare environment detection and storage utilities
- */
-/**
- * Detects if running in Cloudflare environment and returns appropriate storage configuration
- */
-export 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()
-    };
-}
-/**
- * Gets the appropriate storage path for the current environment
- * @param subPath - Optional subdirectory within the storage path
- */
-export 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;
-}
-/**
- * Gets service URL based on Cloudflare environment variables
- */
-export function getCloudflareServiceUrl(fallbackPort = 3000) {
-    if (process.env.CF_PAGES_URL) {
-        return process.env.CF_PAGES_URL;
-    }
-    if (process.env.CF_WORKER_URL) {
-        return process.env.CF_WORKER_URL;
-    }
-    // Local development fallback
-    return `http://localhost:${fallbackPort}`;
-}

package/dist/lib/date.d.ts

@@ -1,17 +0,0 @@
-/**
- * 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
- */
-export 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
- */
-export declare function formatRelativeDate(date: Date): string;
-//# sourceMappingURL=date.d.ts.map

package/dist/lib/date.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/lib/date.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAU/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,UAW5C"}

package/dist/lib/date.js

@@ -1,37 +0,0 @@
-import { format, isToday, isYesterday } from "date-fns";
-/**
- * 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
- */
-export function formatDate(stringOrDate) {
-    if (!stringOrDate)
-        return "";
-    const date = new Date(stringOrDate);
-    return date.toLocaleDateString(undefined, {
-        year: "numeric",
-        month: "short",
-        day: "numeric",
-    });
-}
-/**
- * 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
- */
-export function formatRelativeDate(date) {
-    if (isToday(date)) {
-        return `Today, ${format(date, "h:mm a")}`;
-    }
-    if (isYesterday(date)) {
-        return `Yesterday, ${format(date, "h:mm a")}`;
-    }
-    if (new Date().getFullYear() === date.getFullYear()) {
-        return format(date, "MMM d, h:mm a");
-    }
-    return format(date, "MMM d, yyyy");
-}

package/dist/lib/markdown.d.ts

@@ -1,7 +0,0 @@
-/**
- * Strips markdown from a string
- * @param markdown - The markdown string to strip
- * @returns The stripped markdown string
- */
-export declare function stripMarkdown(markdown: string): Promise<string>;
-//# sourceMappingURL=markdown.d.ts.map

package/dist/lib/markdown.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/lib/markdown.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,mBAGnD"}

package/dist/lib/markdown.js

@@ -1,11 +0,0 @@
-import { remark } from "remark";
-import strip from "strip-markdown";
-/**
- * Strips markdown from a string
- * @param markdown - The markdown string to strip
- * @returns The stripped markdown string
- */
-export async function stripMarkdown(markdown) {
-    const file = await remark().use(strip).process(markdown);
-    return String(file);
-}

package/dist/lib/object.d.ts

@@ -1,15 +0,0 @@
-/**
- * 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
- */
-export 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
- */
-export declare function pruneEmpty<T extends Record<string, unknown>>(obj: T | undefined): Partial<T>;
-//# sourceMappingURL=object.d.ts.map

package/dist/lib/object.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../src/lib/object.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACtC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBxB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,GAAG,EAAE,CAAC,GAAG,SAAS,GAChB,OAAO,CAAC,CAAC,CAAC,CAiBZ"}