@hybrd/utils 1.0.8 → 1.1.0

package/dist/lib/object.js

@@ -1,42 +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 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;
-}
-/**
- * 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 function pruneEmpty(obj) {
-    if (!obj) {
-        return {};
-    }
-    return Object.entries(obj).reduce((acc, [key, value]) => {
-        // Skip undefined, null, and empty strings
-        if (value === undefined || value === null || value === "") {
-            return acc;
-        }
-        // Avoid spread syntax on accumulator
-        acc[key] = value;
-        return acc;
-    }, {});
-}

package/dist/lib/storage.d.ts

@@ -1,24 +0,0 @@
-export 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>;
-}
-export 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>;
-}
-export 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>;
-}
-export declare function createStorageAdapter(): StorageAdapter | null;
-//# sourceMappingURL=storage.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/lib/storage.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClE,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5C,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1C;AAED,qBAAa,gBAAiB,YAAW,cAAc;IACzC,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,GAAG;IAEzB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlE,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK5C,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhD;AAED,qBAAa,uBAAwB,YAAW,cAAc;IAChD,OAAO,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,MAAM;IAEtC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5C,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAEhD;AAED,wBAAgB,oBAAoB,IAAI,cAAc,GAAG,IAAI,CAU5D"}

package/dist/lib/storage.js

@@ -1,50 +0,0 @@
-import fs from "node:fs/promises";
-export class R2StorageAdapter {
-    bucket;
-    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);
-    }
-}
-export class ExternalDatabaseAdapter {
-    connectionString;
-    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) {
-    }
-}
-export 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;
-}

package/dist/lib/string.d.ts

@@ -1,11 +0,0 @@
-/**
- * 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.
- */
-export declare function truncate(str: string, length: number): string;
-//# sourceMappingURL=string.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/lib/string.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAEnD"}

package/dist/lib/string.js

@@ -1,12 +0,0 @@
-/**
- * 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.
- */
-export function truncate(str, length) {
-    return str.length > length ? `${str.slice(0, length)}...` : str;
-}

package/dist/lib/urls.d.ts

@@ -1,28 +0,0 @@
-/**
- * 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)
- */
-export declare function getUrl(path?: string): string;
-//# sourceMappingURL=urls.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../../src/lib/urls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,MAAM,CAAC,IAAI,SAAK,UAY/B"}

package/dist/lib/urls.js

@@ -1,36 +0,0 @@
-/**
- * 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)
- */
-export 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}`;
-}

package/dist/lib/uuid.d.ts

@@ -1,2 +0,0 @@
-export declare function randomUUID(): string;
-//# sourceMappingURL=uuid.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../src/lib/uuid.ts"],"names":[],"mappings":"AAIA,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/lib/uuid.js

@@ -1,6 +0,0 @@
-import { v4 as uuidv4 } from "uuid";
-// The node:crypto version is not supported in the browser.
-// Use the uuid package instead.
-export function randomUUID() {
-    return uuidv4();
-}