npm - @voltagent/internal - Versions diffs - 0.0.2 → 0.0.4 - Mend

@voltagent/internal 0.0.2 → 0.0.4

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 (21) hide show

package/dist/dev/index.d.mts CHANGED Viewed

@@ -52,6 +52,7 @@ declare function createDevLogger(options?: DevLoggerOptions): {
      * @param args - The arguments to log.
      */
     error: (message?: any, ...args: any[]) => void;
+    debug: (_message?: any, ..._args: any[]) => void;
 };
 declare const _default: {
     /**
@@ -96,6 +97,7 @@ declare const _default: {
      * @param args - The arguments to log.
      */
     error: (message?: any, ...args: any[]) => void;
+    debug: (_message?: any, ..._args: any[]) => void;
 };
 export { type DevLoggerOptions, createDevLogger, _default as devLogger };

package/dist/dev/index.d.ts CHANGED Viewed

@@ -52,6 +52,7 @@ declare function createDevLogger(options?: DevLoggerOptions): {
      * @param args - The arguments to log.
      */
     error: (message?: any, ...args: any[]) => void;
+    debug: (_message?: any, ..._args: any[]) => void;
 };
 declare const _default: {
     /**
@@ -96,6 +97,7 @@ declare const _default: {
      * @param args - The arguments to log.
      */
     error: (message?: any, ...args: any[]) => void;
+    debug: (_message?: any, ..._args: any[]) => void;
 };
 export { type DevLoggerOptions, createDevLogger, _default as devLogger };

package/dist/dev/index.js CHANGED Viewed

@@ -86,13 +86,17 @@ function createDevLogger(options) {
       if (isDev()) {
         console.error(formatLogPrefix("ERROR"), message, ...args);
       }
-    }, "error")
+    }, "error"),
+    debug: /* @__PURE__ */ __name((_message, ..._args) => {
+      return;
+    }, "debug")
   };
 }
 __name(createDevLogger, "createDevLogger");
 var logger_default = createDevLogger();
 function isDevNodeEnv() {
-  return process.env.NODE_ENV === "development";
+  const nodeEnv = process.env.NODE_ENV;
+  return nodeEnv !== "production" && nodeEnv !== "test" && nodeEnv !== "ci";
 }
 __name(isDevNodeEnv, "isDevNodeEnv");
 function formatLogPrefix(level) {

package/dist/dev/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/dev/index.ts","../../src/dev/logger.ts"],"sourcesContent":["export { createDevLogger, default as devLogger } from \"./logger\";\nexport type { DevLoggerOptions } from \"./logger\";\n","export interface DevLoggerOptions {\n dev: boolean \| (() => boolean);\n}\n\n/*\n A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n /\nexport function createDevLogger(options?: DevLoggerOptions) {\n const isDev =\n typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n return {\n /\n Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n info: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.info(formatLogPrefix(\"INFO\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.warn(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n warn: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development.\n \n @example\n * ```typescript\n * devLogger.error(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n */\n error: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n }\n },\n };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n ~~return~~ process.env.NODE_ENV ~~===~~ \"~~development~~\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" \| \"WARN\" \| \"ERROR\"): string {\n return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACYO,SAAS,gBAAgB,SAA4B;AAC1D,QAAM,QACJ,QAAO,mCAAS,SAAQ,aAAa,QAAQ,MAAM,MAAG;AAd1D;AAc6D,oDAAS,QAAT,YAAgB,aAAa;AAAA;AAExF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAcL,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,OAAO,wBAAC,YAAkB,SAAgB;AACxC,UAAI,MAAM,GAAG;AACX,gBAAQ,MAAM,gBAAgB,OAAO,GAAG,SAAS,GAAG,IAAI;AAAA,MAC1D;AAAA,IACF,GAJO;AAAA,~~EAKT~~;AACF;~~AA5DgB~~;~~AA8DhB~~,IAAO,iBAAQ,gBAAgB;AAE/B,SAAS,eAAe;AACtB,~~SAAO~~,QAAQ,IAAI,~~aAAa~~;~~AAClC~~;~~AAFS~~;~~AAIT~~,SAAS,gBAAgB,~~OAA0C~~;~~AACjE~~,SAAO,gBAAgB,UAAU,CAAC,KAAK,KAAK;AAC9C;AAFS;AAIT,SAAS,YAAoB;AAC3B,UAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE;AAC/D;AAFS;","names":[]}
1	+ {"version":3,"sources":["../../src/dev/index.ts","../../src/dev/logger.ts"],"sourcesContent":["export { createDevLogger, default as devLogger } from \"./logger\";\nexport type { DevLoggerOptions } from \"./logger\";\n","export interface DevLoggerOptions {\n dev: boolean \| (() => boolean);\n}\n\n/*\n A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n /\nexport function createDevLogger(options?: DevLoggerOptions) {\n const isDev =\n typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n return {\n /\n Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n info: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.info(formatLogPrefix(\"INFO\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.warn(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n warn: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development.\n \n @example\n * ```typescript\n * devLogger.error(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n */\n error: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n }\n },\n\n debug: (_message?: any, ..._args: any[]) => {\n // todo: implement debug logging with pino\n return;\n },\n };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n const nodeEnv = process.env.NODE_ENV;\n return nodeEnv !== \"production\" && nodeEnv !== \"test\" && nodeEnv !== \"ci\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" \| \"WARN\" \| \"ERROR\" \| \"DEBUG\"): string {\n return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACYO,SAAS,gBAAgB,SAA4B;AAC1D,QAAM,QACJ,QAAO,mCAAS,SAAQ,aAAa,QAAQ,MAAM,MAAG;AAd1D;AAc6D,oDAAS,QAAT,YAAgB,aAAa;AAAA;AAExF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAcL,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,OAAO,wBAAC,YAAkB,SAAgB;AACxC,UAAI,MAAM,GAAG;AACX,gBAAQ,MAAM,gBAAgB,OAAO,GAAG,SAAS,GAAG,IAAI;AAAA,MAC1D;AAAA,IACF,GAJO;AAAA,IAMP,OAAO,wBAAC,aAAmB,UAAiB;AAE1C;AAAA,IACF,GAHO;AAAA,EAIT;AACF;AAjEgB;AAmEhB,IAAO,iBAAQ,gBAAgB;AAE/B,SAAS,eAAe;AACtB,QAAM,UAAU,QAAQ,IAAI;AAC5B,SAAO,YAAY,gBAAgB,YAAY,UAAU,YAAY;AACvE;AAHS;AAKT,SAAS,gBAAgB,OAAoD;AAC3E,SAAO,gBAAgB,UAAU,CAAC,KAAK,KAAK;AAC9C;AAFS;AAIT,SAAS,YAAoB;AAC3B,UAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE;AAC/D;AAFS;","names":[]}

package/dist/dev/index.mjs CHANGED Viewed

@@ -61,13 +61,17 @@ function createDevLogger(options) {
       if (isDev()) {
         console.error(formatLogPrefix("ERROR"), message, ...args);
       }
-    }, "error")
+    }, "error"),
+    debug: /* @__PURE__ */ __name((_message, ..._args) => {
+      return;
+    }, "debug")
   };
 }
 __name(createDevLogger, "createDevLogger");
 var logger_default = createDevLogger();
 function isDevNodeEnv() {
-  return process.env.NODE_ENV === "development";
+  const nodeEnv = process.env.NODE_ENV;
+  return nodeEnv !== "production" && nodeEnv !== "test" && nodeEnv !== "ci";
 }
 __name(isDevNodeEnv, "isDevNodeEnv");
 function formatLogPrefix(level) {

package/dist/dev/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/dev/logger.ts"],"sourcesContent":["export interface DevLoggerOptions {\n dev: boolean \| (() => boolean);\n}\n\n/*\n A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n /\nexport function createDevLogger(options?: DevLoggerOptions) {\n const isDev =\n typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n return {\n /\n Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n info: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.info(formatLogPrefix(\"INFO\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.warn(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n warn: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development.\n \n @example\n * ```typescript\n * devLogger.error(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n */\n error: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n }\n },\n };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n ~~return~~ process.env.NODE_ENV ~~===~~ \"~~development~~\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" \| \"WARN\" \| \"ERROR\"): string {\n return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n"],"mappings":";;;;AAYO,SAAS,gBAAgB,SAA4B;AAC1D,QAAM,QACJ,QAAO,mCAAS,SAAQ,aAAa,QAAQ,MAAM,MAAG;AAd1D;AAc6D,oDAAS,QAAT,YAAgB,aAAa;AAAA;AAExF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAcL,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,OAAO,wBAAC,YAAkB,SAAgB;AACxC,UAAI,MAAM,GAAG;AACX,gBAAQ,MAAM,gBAAgB,OAAO,GAAG,SAAS,GAAG,IAAI;AAAA,MAC1D;AAAA,IACF,GAJO;AAAA,~~EAKT~~;AACF;~~AA5DgB~~;~~AA8DhB~~,IAAO,iBAAQ,gBAAgB;AAE/B,SAAS,eAAe;AACtB,~~SAAO~~,QAAQ,IAAI,~~aAAa~~;~~AAClC~~;~~AAFS~~;~~AAIT~~,SAAS,gBAAgB,~~OAA0C~~;~~AACjE~~,SAAO,gBAAgB,UAAU,CAAC,KAAK,KAAK;AAC9C;AAFS;AAIT,SAAS,YAAoB;AAC3B,UAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE;AAC/D;AAFS;","names":[]}
1	+ {"version":3,"sources":["../../src/dev/logger.ts"],"sourcesContent":["export interface DevLoggerOptions {\n dev: boolean \| (() => boolean);\n}\n\n/*\n A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n /\nexport function createDevLogger(options?: DevLoggerOptions) {\n const isDev =\n typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n return {\n /\n Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n info: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.info(formatLogPrefix(\"INFO\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.warn(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n warn: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development.\n \n @example\n * ```typescript\n * devLogger.error(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n */\n error: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n }\n },\n\n debug: (_message?: any, ..._args: any[]) => {\n // todo: implement debug logging with pino\n return;\n },\n };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n const nodeEnv = process.env.NODE_ENV;\n return nodeEnv !== \"production\" && nodeEnv !== \"test\" && nodeEnv !== \"ci\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" \| \"WARN\" \| \"ERROR\" \| \"DEBUG\"): string {\n return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n"],"mappings":";;;;AAYO,SAAS,gBAAgB,SAA4B;AAC1D,QAAM,QACJ,QAAO,mCAAS,SAAQ,aAAa,QAAQ,MAAM,MAAG;AAd1D;AAc6D,oDAAS,QAAT,YAAgB,aAAa;AAAA;AAExF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAcL,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,OAAO,wBAAC,YAAkB,SAAgB;AACxC,UAAI,MAAM,GAAG;AACX,gBAAQ,MAAM,gBAAgB,OAAO,GAAG,SAAS,GAAG,IAAI;AAAA,MAC1D;AAAA,IACF,GAJO;AAAA,IAMP,OAAO,wBAAC,aAAmB,UAAiB;AAE1C;AAAA,IACF,GAHO;AAAA,EAIT;AACF;AAjEgB;AAmEhB,IAAO,iBAAQ,gBAAgB;AAE/B,SAAS,eAAe;AACtB,QAAM,UAAU,QAAQ,IAAI;AAC5B,SAAO,YAAY,gBAAgB,YAAY,UAAU,YAAY;AACvE;AAHS;AAKT,SAAS,gBAAgB,OAAoD;AAC3E,SAAO,gBAAgB,UAAU,CAAC,KAAK,KAAK;AAC9C;AAFS;AAIT,SAAS,YAAoB;AAC3B,UAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE;AAC/D;AAFS;","names":[]}

package/dist/main/index.d.mts CHANGED Viewed

@@ -1,3 +1,5 @@
+import { SetRequired, EmptyObject } from 'type-fest';
 interface DevLoggerOptions {
     dev: boolean | (() => boolean);
 }
@@ -52,6 +54,7 @@ declare function createDevLogger(options?: DevLoggerOptions): {
      * @param args - The arguments to log.
      */
     error: (message?: any, ...args: any[]) => void;
+    debug: (_message?: any, ..._args: any[]) => void;
 };
 declare const _default: {
     /**
@@ -96,6 +99,7 @@ declare const _default: {
      * @param args - The arguments to log.
      */
     error: (message?: any, ...args: any[]) => void;
+    debug: (_message?: any, ..._args: any[]) => void;
 };
 /**
@@ -130,8 +134,27 @@ declare function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T>
 declare function convertResponseStreamToArray(response: Response): Promise<string[]>;
 /**
- * Object manipulation utility functions
+ * A plain object is an object that has no special properties or methods,
+ * and just has properties that are strings, numbers, or symbols.
+ */
+type PlainObject = Record<string | number | symbol, unknown>;
+/**
+ * A nil value is a value that is not defined or is undefined.
+ */
+type Nil = null | undefined;
+/**
+ * A type that represents any async function.
+ */
+type AnyAsyncFunction = (...args: unknown[]) => Promise<unknown>;
+/**
+ * A type that represents any synchronous function.
  */
+type AnySyncFunction = (...args: unknown[]) => unknown;
+/**
+ * A type that represents any function.
+ */
+type AnyFunction = AnyAsyncFunction | AnySyncFunction;
 /**
  * Deep clone an object using JSON serialization with fallback to shallow clone
  *
@@ -139,5 +162,49 @@ declare function convertResponseStreamToArray(response: Response): Promise<strin
  * @returns A deep copy of the object, or shallow copy if JSON serialization fails
  */
 declare function deepClone<T>(obj: T): T;
+/**
+ * Check if an object has a key
+ *
+ * @param obj - The object to check
+ * @param key - The key to check
+ * @returns True if the object has the key, false otherwise
+ */
+declare function hasKey<T extends PlainObject, K extends string>(obj: T, key: K): obj is T & SetRequired<T, K>;
+/**
+ * Check if a value is nil
+ *
+ * @param obj - The value to check
+ * @returns True if the value is nil, false otherwise
+ */
+declare function isNil(obj: unknown): obj is Nil;
+/**
+ * Check if an object is a JS object
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a JS object}
+ */
+declare function isObject<T extends object>(obj: unknown): obj is T;
+/**
+ * Check if a value is a function
+ *
+ * @param obj - The value to check
+ * @returns True if the value is a function, false otherwise
+ */
+declare function isFunction<T extends AnyFunction>(obj: unknown): obj is T;
+/**
+ * Check if an object is a plain object (i.e. a JS object but not including arrays or functions)
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a plain object, false otherwise.
+ */
+declare function isPlainObject<T extends PlainObject>(obj: unknown): obj is T;
+/**
+ * Check if an object is an empty object
+ *
+ * @param obj - The object to check
+ * @returns True if the object is an empty object, false otherwise
+ */
+declare function isEmptyObject(obj: unknown): obj is EmptyObject;
-export { type DevLoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createDevLogger, deepClone, _default as devLogger };
+export { type DevLoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createDevLogger, deepClone, _default as devLogger, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject };

package/dist/main/index.d.ts CHANGED Viewed

@@ -1,3 +1,5 @@
+import { SetRequired, EmptyObject } from 'type-fest';
 interface DevLoggerOptions {
     dev: boolean | (() => boolean);
 }
@@ -52,6 +54,7 @@ declare function createDevLogger(options?: DevLoggerOptions): {
      * @param args - The arguments to log.
      */
     error: (message?: any, ...args: any[]) => void;
+    debug: (_message?: any, ..._args: any[]) => void;
 };
 declare const _default: {
     /**
@@ -96,6 +99,7 @@ declare const _default: {
      * @param args - The arguments to log.
      */
     error: (message?: any, ...args: any[]) => void;
+    debug: (_message?: any, ..._args: any[]) => void;
 };
 /**
@@ -130,8 +134,27 @@ declare function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T>
 declare function convertResponseStreamToArray(response: Response): Promise<string[]>;
 /**
- * Object manipulation utility functions
+ * A plain object is an object that has no special properties or methods,
+ * and just has properties that are strings, numbers, or symbols.
+ */
+type PlainObject = Record<string | number | symbol, unknown>;
+/**
+ * A nil value is a value that is not defined or is undefined.
+ */
+type Nil = null | undefined;
+/**
+ * A type that represents any async function.
+ */
+type AnyAsyncFunction = (...args: unknown[]) => Promise<unknown>;
+/**
+ * A type that represents any synchronous function.
  */
+type AnySyncFunction = (...args: unknown[]) => unknown;
+/**
+ * A type that represents any function.
+ */
+type AnyFunction = AnyAsyncFunction | AnySyncFunction;
 /**
  * Deep clone an object using JSON serialization with fallback to shallow clone
  *
@@ -139,5 +162,49 @@ declare function convertResponseStreamToArray(response: Response): Promise<strin
  * @returns A deep copy of the object, or shallow copy if JSON serialization fails
  */
 declare function deepClone<T>(obj: T): T;
+/**
+ * Check if an object has a key
+ *
+ * @param obj - The object to check
+ * @param key - The key to check
+ * @returns True if the object has the key, false otherwise
+ */
+declare function hasKey<T extends PlainObject, K extends string>(obj: T, key: K): obj is T & SetRequired<T, K>;
+/**
+ * Check if a value is nil
+ *
+ * @param obj - The value to check
+ * @returns True if the value is nil, false otherwise
+ */
+declare function isNil(obj: unknown): obj is Nil;
+/**
+ * Check if an object is a JS object
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a JS object}
+ */
+declare function isObject<T extends object>(obj: unknown): obj is T;
+/**
+ * Check if a value is a function
+ *
+ * @param obj - The value to check
+ * @returns True if the value is a function, false otherwise
+ */
+declare function isFunction<T extends AnyFunction>(obj: unknown): obj is T;
+/**
+ * Check if an object is a plain object (i.e. a JS object but not including arrays or functions)
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a plain object, false otherwise.
+ */
+declare function isPlainObject<T extends PlainObject>(obj: unknown): obj is T;
+/**
+ * Check if an object is an empty object
+ *
+ * @param obj - The object to check
+ * @returns True if the object is an empty object, false otherwise
+ */
+declare function isEmptyObject(obj: unknown): obj is EmptyObject;
-export { type DevLoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createDevLogger, deepClone, _default as devLogger };
+export { type DevLoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createDevLogger, deepClone, _default as devLogger, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject };

package/dist/main/index.js CHANGED Viewed

@@ -79,7 +79,13 @@ __export(index_exports, {
   convertResponseStreamToArray: () => convertResponseStreamToArray,
   createDevLogger: () => createDevLogger,
   deepClone: () => deepClone,
-  devLogger: () => logger_default
+  devLogger: () => logger_default,
+  hasKey: () => hasKey,
+  isEmptyObject: () => isEmptyObject,
+  isFunction: () => isFunction,
+  isNil: () => isNil,
+  isObject: () => isObject,
+  isPlainObject: () => isPlainObject
 });
 module.exports = __toCommonJS(index_exports);
@@ -143,13 +149,17 @@ function createDevLogger(options) {
       if (isDev()) {
         console.error(formatLogPrefix("ERROR"), message, ...args);
       }
-    }, "error")
+    }, "error"),
+    debug: /* @__PURE__ */ __name((_message, ..._args) => {
+      return;
+    }, "debug")
   };
 }
 __name(createDevLogger, "createDevLogger");
 var logger_default = createDevLogger();
 function isDevNodeEnv() {
-  return process.env.NODE_ENV === "development";
+  const nodeEnv = process.env.NODE_ENV;
+  return nodeEnv !== "production" && nodeEnv !== "test" && nodeEnv !== "ci";
 }
 __name(isDevNodeEnv, "isDevNodeEnv");
 function formatLogPrefix(level) {
@@ -230,7 +240,39 @@ function convertResponseStreamToArray(response) {
 }
 __name(convertResponseStreamToArray, "convertResponseStreamToArray");
-// src/utils/object-utils.ts
+// src/utils/lang.ts
+function isNil(obj) {
+  return obj === null || obj === void 0;
+}
+__name(isNil, "isNil");
+function isObject(obj) {
+  return (typeof obj === "object" || typeof obj === "function") && !isNil(obj);
+}
+__name(isObject, "isObject");
+function isFunction(obj) {
+  return typeof obj === "function";
+}
+__name(isFunction, "isFunction");
+function isPlainObject(obj) {
+  if (!isObject(obj)) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(obj);
+  return prototype === Object.prototype || prototype === null;
+}
+__name(isPlainObject, "isPlainObject");
+function isEmptyObject(obj) {
+  if (!isObject(obj)) {
+    return false;
+  }
+  if (Object.getOwnPropertyNames(obj).length > 0 || Object.getOwnPropertySymbols(obj).length > 0) {
+    return false;
+  }
+  return true;
+}
+__name(isEmptyObject, "isEmptyObject");
+// src/utils/objects.ts
 function deepClone(obj) {
   try {
     return JSON.parse(JSON.stringify(obj));
@@ -243,6 +285,10 @@ function deepClone(obj) {
   }
 }
 __name(deepClone, "deepClone");
+function hasKey(obj, key) {
+  return isObject(obj) && key in obj;
+}
+__name(hasKey, "hasKey");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   convertArrayToAsyncIterable,
@@ -252,6 +298,12 @@ __name(deepClone, "deepClone");
   convertResponseStreamToArray,
   createDevLogger,
   deepClone,
-  devLogger
+  devLogger,
+  hasKey,
+  isEmptyObject,
+  isFunction,
+  isNil,
+  isObject,
+  isPlainObject
 });
 //# sourceMappingURL=index.js.map

package/dist/main/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/index.ts","../../src/dev/logger.ts","../../src/test/conversions.ts","../../src/utils/object-utils.ts"],"sourcesContent":["export * from \"./dev\";\nexport * from \"./test\";\nexport * from \"./utils\";\n","export interface DevLoggerOptions {\n dev: boolean \| (() => boolean);\n}\n\n/*\n A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n /\nexport function createDevLogger(options?: DevLoggerOptions) {\n const isDev =\n typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n return {\n /\n Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n info: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.info(formatLogPrefix(\"INFO\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.warn(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n warn: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development.\n \n @example\n * ```typescript\n * devLogger.error(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n error: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n }\n },\n };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n return process.env.NODE_ENV === \"development\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" \| \"WARN\" \| \"ERROR\"): string {\n return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n","/\n Convert a readable stream to an array\n * @param stream - The readable stream to convert\n * @returns The array of values\n /\nexport async function convertReadableStreamToArray<T>(stream: ReadableStream<T>): Promise<T[]> {\n const reader = stream.getReader();\n const result: T[] = [];\n\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n result.push(value);\n }\n\n return result;\n}\n\n/\n Convert an array to an async iterable\n * @param values - The array to convert\n * @returns The async iterable\n /\nexport function convertArrayToAsyncIterable<T>(values: T[]): AsyncIterable<T> {\n return {\n async [Symbol.asyncIterator]() {\n for (const value of values) {\n yield value;\n }\n },\n };\n}\n\n/*\n Convert an async iterable to an array\n * @param iterable - The async iterable to convert\n * @returns The array of values\n /\nexport async function convertAsyncIterableToArray<T>(iterable: AsyncIterable<T>): Promise<T[]> {\n const result: T[] = [];\n for await (const item of iterable) {\n result.push(item);\n }\n return result;\n}\n\n/\n Convert an array to a readable stream\n * @param values - The array to convert\n * @returns The readable stream\n /\nexport function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T> {\n return new ReadableStream({\n start(controller) {\n try {\n for (const value of values) {\n controller.enqueue(value);\n }\n } finally {\n controller.close();\n }\n },\n });\n}\n\n/\n Convert a response stream to an array\n * @param response - The response to convert\n * @returns The array of values\n /\nexport async function convertResponseStreamToArray(response: Response): Promise<string[]> {\n // biome-ignore lint/style/noNonNullAssertion: ignore this\n return convertReadableStreamToArray(response.body!.pipeThrough(new TextDecoderStream()));\n}\n","/\n Object manipulation utility functions\n /\n\nimport { devLogger } from \"../dev\";\n\n/\n Deep clone an object using JSON serialization with fallback to shallow clone\n \n @param obj - The object to clone\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n */\nexport function deepClone<T>(obj: T): T {\n try {\n return JSON.parse(JSON.stringify(obj));\n } catch (error) {\n devLogger.warn(\"Failed to deep clone object, using shallow clone:\", error);\n // Fallback to shallow clone for primitive types and simple objects\n if (obj === null \|\| typeof obj !== \"object\") {\n return obj;\n }\n return { ...obj } as T;\n }\n}\n"],"mappings":"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","names":[]}
1	+ {"version":3,"sources":["../../src/index.ts","../../src/dev/logger.ts","../../src/test/conversions.ts","../../src/utils/lang.ts","../../src/utils/objects.ts"],"sourcesContent":["export * from \"./dev\";\nexport * from \"./test\";\nexport * from \"./utils\";\n","export interface DevLoggerOptions {\n dev: boolean \| (() => boolean);\n}\n\n/*\n A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n /\nexport function createDevLogger(options?: DevLoggerOptions) {\n const isDev =\n typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n return {\n /\n Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n info: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.info(formatLogPrefix(\"INFO\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.warn(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n warn: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development.\n \n @example\n * ```typescript\n * devLogger.error(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n error: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n }\n },\n\n debug: (_message?: any, ..._args: any[]) => {\n // todo: implement debug logging with pino\n return;\n },\n };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n const nodeEnv = process.env.NODE_ENV;\n return nodeEnv !== \"production\" && nodeEnv !== \"test\" && nodeEnv !== \"ci\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" \| \"WARN\" \| \"ERROR\" \| \"DEBUG\"): string {\n return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n","/\n Convert a readable stream to an array\n * @param stream - The readable stream to convert\n * @returns The array of values\n /\nexport async function convertReadableStreamToArray<T>(stream: ReadableStream<T>): Promise<T[]> {\n const reader = stream.getReader();\n const result: T[] = [];\n\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n result.push(value);\n }\n\n return result;\n}\n\n/\n Convert an array to an async iterable\n * @param values - The array to convert\n * @returns The async iterable\n /\nexport function convertArrayToAsyncIterable<T>(values: T[]): AsyncIterable<T> {\n return {\n async [Symbol.asyncIterator]() {\n for (const value of values) {\n yield value;\n }\n },\n };\n}\n\n/*\n Convert an async iterable to an array\n * @param iterable - The async iterable to convert\n * @returns The array of values\n /\nexport async function convertAsyncIterableToArray<T>(iterable: AsyncIterable<T>): Promise<T[]> {\n const result: T[] = [];\n for await (const item of iterable) {\n result.push(item);\n }\n return result;\n}\n\n/\n Convert an array to a readable stream\n * @param values - The array to convert\n * @returns The readable stream\n /\nexport function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T> {\n return new ReadableStream({\n start(controller) {\n try {\n for (const value of values) {\n controller.enqueue(value);\n }\n } finally {\n controller.close();\n }\n },\n });\n}\n\n/\n Convert a response stream to an array\n * @param response - The response to convert\n * @returns The array of values\n /\nexport async function convertResponseStreamToArray(response: Response): Promise<string[]> {\n // biome-ignore lint/style/noNonNullAssertion: ignore this\n return convertReadableStreamToArray(response.body!.pipeThrough(new TextDecoderStream()));\n}\n","import type { EmptyObject } from \"type-fest\";\nimport type { AnyFunction, Nil, PlainObject } from \"../types\";\n\n/\n Check if a value is nil\n \n @param obj - The value to check\n * @returns True if the value is nil, false otherwise\n /\nexport function isNil(obj: unknown): obj is Nil {\n return obj === null \|\| obj === undefined;\n}\n\n/\n Check if an object is a JS object\n \n @param obj - The object to check\n * @returns True if the object is a JS object}\n /\nexport function isObject<T extends object>(obj: unknown): obj is T {\n return (typeof obj === \"object\" \|\| typeof obj === \"function\") && !isNil(obj);\n}\n\n/\n Check if a value is a function\n \n @param obj - The value to check\n * @returns True if the value is a function, false otherwise\n /\nexport function isFunction<T extends AnyFunction>(obj: unknown): obj is T {\n return typeof obj === \"function\";\n}\n\n/\n Check if an object is a plain object (i.e. a JS object but not including arrays or functions)\n \n @param obj - The object to check\n * @returns True if the object is a plain object, false otherwise.\n /\nexport function isPlainObject<T extends PlainObject>(obj: unknown): obj is T {\n if (!isObject(obj)) {\n return false;\n }\n\n const prototype = Object.getPrototypeOf(obj);\n return prototype === Object.prototype \|\| prototype === null;\n}\n\n/\n Check if an object is an empty object\n \n @param obj - The object to check\n * @returns True if the object is an empty object, false otherwise\n /\nexport function isEmptyObject(obj: unknown): obj is EmptyObject {\n if (!isObject(obj)) {\n return false;\n }\n\n // Check for own string and symbol properties (enumerable or not)\n if (Object.getOwnPropertyNames(obj).length > 0 \|\| Object.getOwnPropertySymbols(obj).length > 0) {\n return false;\n }\n\n return true;\n}\n","import type { SetRequired } from \"type-fest\";\nimport { devLogger } from \"../dev\";\nimport type { PlainObject } from \"../types\";\nimport { isObject } from \"./lang\";\n\n/\n Deep clone an object using JSON serialization with fallback to shallow clone\n \n @param obj - The object to clone\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n /\nexport function deepClone<T>(obj: T): T {\n try {\n return JSON.parse(JSON.stringify(obj));\n } catch (error) {\n devLogger.warn(\"Failed to deep clone object, using shallow clone:\", error);\n // Fallback to shallow clone for primitive types and simple objects\n if (obj === null \|\| typeof obj !== \"object\") {\n return obj;\n }\n return { ...obj } as T;\n }\n}\n\n/\n Check if an object has a key\n \n @param obj - The object to check\n * @param key - The key to check\n * @returns True if the object has the key, false otherwise\n */\nexport function hasKey<T extends PlainObject, K extends string>(\n obj: T,\n key: K,\n): obj is T & SetRequired<T, K> {\n return isObject(obj) && key in obj;\n}\n"],"mappings":"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","names":[]}

package/dist/main/index.mjs CHANGED Viewed

@@ -113,13 +113,17 @@ function createDevLogger(options) {
       if (isDev()) {
         console.error(formatLogPrefix("ERROR"), message, ...args);
       }
-    }, "error")
+    }, "error"),
+    debug: /* @__PURE__ */ __name((_message, ..._args) => {
+      return;
+    }, "debug")
   };
 }
 __name(createDevLogger, "createDevLogger");
 var logger_default = createDevLogger();
 function isDevNodeEnv() {
-  return process.env.NODE_ENV === "development";
+  const nodeEnv = process.env.NODE_ENV;
+  return nodeEnv !== "production" && nodeEnv !== "test" && nodeEnv !== "ci";
 }
 __name(isDevNodeEnv, "isDevNodeEnv");
 function formatLogPrefix(level) {
@@ -200,7 +204,39 @@ function convertResponseStreamToArray(response) {
 }
 __name(convertResponseStreamToArray, "convertResponseStreamToArray");
-// src/utils/object-utils.ts
+// src/utils/lang.ts
+function isNil(obj) {
+  return obj === null || obj === void 0;
+}
+__name(isNil, "isNil");
+function isObject(obj) {
+  return (typeof obj === "object" || typeof obj === "function") && !isNil(obj);
+}
+__name(isObject, "isObject");
+function isFunction(obj) {
+  return typeof obj === "function";
+}
+__name(isFunction, "isFunction");
+function isPlainObject(obj) {
+  if (!isObject(obj)) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(obj);
+  return prototype === Object.prototype || prototype === null;
+}
+__name(isPlainObject, "isPlainObject");
+function isEmptyObject(obj) {
+  if (!isObject(obj)) {
+    return false;
+  }
+  if (Object.getOwnPropertyNames(obj).length > 0 || Object.getOwnPropertySymbols(obj).length > 0) {
+    return false;
+  }
+  return true;
+}
+__name(isEmptyObject, "isEmptyObject");
+// src/utils/objects.ts
 function deepClone(obj) {
   try {
     return JSON.parse(JSON.stringify(obj));
@@ -213,6 +249,10 @@ function deepClone(obj) {
   }
 }
 __name(deepClone, "deepClone");
+function hasKey(obj, key) {
+  return isObject(obj) && key in obj;
+}
+__name(hasKey, "hasKey");
 export {
   convertArrayToAsyncIterable,
   convertArrayToReadableStream,
@@ -221,6 +261,12 @@ export {
   convertResponseStreamToArray,
   createDevLogger,
   deepClone,
-  logger_default as devLogger
+  logger_default as devLogger,
+  hasKey,
+  isEmptyObject,
+  isFunction,
+  isNil,
+  isObject,
+  isPlainObject
 };
 //# sourceMappingURL=index.mjs.map

package/dist/main/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/dev/logger.ts","../../src/test/conversions.ts","../../src/utils/object-utils.ts"],"sourcesContent":["export interface DevLoggerOptions {\n dev: boolean \| (() => boolean);\n}\n\n/*\n A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n /\nexport function createDevLogger(options?: DevLoggerOptions) {\n const isDev =\n typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n return {\n /\n Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n info: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.info(formatLogPrefix(\"INFO\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.warn(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n warn: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development.\n \n @example\n * ```typescript\n * devLogger.error(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n error: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n }\n },\n };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n return process.env.NODE_ENV === \"development\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" \| \"WARN\" \| \"ERROR\"): string {\n return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n","/\n Convert a readable stream to an array\n * @param stream - The readable stream to convert\n * @returns The array of values\n /\nexport async function convertReadableStreamToArray<T>(stream: ReadableStream<T>): Promise<T[]> {\n const reader = stream.getReader();\n const result: T[] = [];\n\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n result.push(value);\n }\n\n return result;\n}\n\n/\n Convert an array to an async iterable\n * @param values - The array to convert\n * @returns The async iterable\n /\nexport function convertArrayToAsyncIterable<T>(values: T[]): AsyncIterable<T> {\n return {\n async [Symbol.asyncIterator]() {\n for (const value of values) {\n yield value;\n }\n },\n };\n}\n\n/*\n Convert an async iterable to an array\n * @param iterable - The async iterable to convert\n * @returns The array of values\n /\nexport async function convertAsyncIterableToArray<T>(iterable: AsyncIterable<T>): Promise<T[]> {\n const result: T[] = [];\n for await (const item of iterable) {\n result.push(item);\n }\n return result;\n}\n\n/\n Convert an array to a readable stream\n * @param values - The array to convert\n * @returns The readable stream\n /\nexport function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T> {\n return new ReadableStream({\n start(controller) {\n try {\n for (const value of values) {\n controller.enqueue(value);\n }\n } finally {\n controller.close();\n }\n },\n });\n}\n\n/\n Convert a response stream to an array\n * @param response - The response to convert\n * @returns The array of values\n /\nexport async function convertResponseStreamToArray(response: Response): Promise<string[]> {\n // biome-ignore lint/style/noNonNullAssertion: ignore this\n return convertReadableStreamToArray(response.body!.pipeThrough(new TextDecoderStream()));\n}\n","/\n Object manipulation utility functions\n /\n\nimport { devLogger } from \"../dev\";\n\n/\n Deep clone an object using JSON serialization with fallback to shallow clone\n \n @param obj - The object to clone\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n */\nexport function deepClone<T>(obj: T): T {\n try {\n return JSON.parse(JSON.stringify(obj));\n } catch (error) {\n devLogger.warn(\"Failed to deep clone object, using shallow clone:\", error);\n // Fallback to shallow clone for primitive types and simple objects\n if (obj === null \|\| typeof obj !== \"object\") {\n return obj;\n }\n return { ...obj } as T;\n }\n}\n"],"mappings":"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","names":[]}
1	+ {"version":3,"sources":["../../src/dev/logger.ts","../../src/test/conversions.ts","../../src/utils/lang.ts","../../src/utils/objects.ts"],"sourcesContent":["export interface DevLoggerOptions {\n dev: boolean \| (() => boolean);\n}\n\n/*\n A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n /\nexport function createDevLogger(options?: DevLoggerOptions) {\n const isDev =\n typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n return {\n /\n Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n info: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.info(formatLogPrefix(\"INFO\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.warn(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n warn: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development.\n \n @example\n * ```typescript\n * devLogger.error(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n error: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n }\n },\n\n debug: (_message?: any, ..._args: any[]) => {\n // todo: implement debug logging with pino\n return;\n },\n };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n const nodeEnv = process.env.NODE_ENV;\n return nodeEnv !== \"production\" && nodeEnv !== \"test\" && nodeEnv !== \"ci\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" \| \"WARN\" \| \"ERROR\" \| \"DEBUG\"): string {\n return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n","/\n Convert a readable stream to an array\n * @param stream - The readable stream to convert\n * @returns The array of values\n /\nexport async function convertReadableStreamToArray<T>(stream: ReadableStream<T>): Promise<T[]> {\n const reader = stream.getReader();\n const result: T[] = [];\n\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n result.push(value);\n }\n\n return result;\n}\n\n/\n Convert an array to an async iterable\n * @param values - The array to convert\n * @returns The async iterable\n /\nexport function convertArrayToAsyncIterable<T>(values: T[]): AsyncIterable<T> {\n return {\n async [Symbol.asyncIterator]() {\n for (const value of values) {\n yield value;\n }\n },\n };\n}\n\n/*\n Convert an async iterable to an array\n * @param iterable - The async iterable to convert\n * @returns The array of values\n /\nexport async function convertAsyncIterableToArray<T>(iterable: AsyncIterable<T>): Promise<T[]> {\n const result: T[] = [];\n for await (const item of iterable) {\n result.push(item);\n }\n return result;\n}\n\n/\n Convert an array to a readable stream\n * @param values - The array to convert\n * @returns The readable stream\n /\nexport function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T> {\n return new ReadableStream({\n start(controller) {\n try {\n for (const value of values) {\n controller.enqueue(value);\n }\n } finally {\n controller.close();\n }\n },\n });\n}\n\n/\n Convert a response stream to an array\n * @param response - The response to convert\n * @returns The array of values\n /\nexport async function convertResponseStreamToArray(response: Response): Promise<string[]> {\n // biome-ignore lint/style/noNonNullAssertion: ignore this\n return convertReadableStreamToArray(response.body!.pipeThrough(new TextDecoderStream()));\n}\n","import type { EmptyObject } from \"type-fest\";\nimport type { AnyFunction, Nil, PlainObject } from \"../types\";\n\n/\n Check if a value is nil\n \n @param obj - The value to check\n * @returns True if the value is nil, false otherwise\n /\nexport function isNil(obj: unknown): obj is Nil {\n return obj === null \|\| obj === undefined;\n}\n\n/\n Check if an object is a JS object\n \n @param obj - The object to check\n * @returns True if the object is a JS object}\n /\nexport function isObject<T extends object>(obj: unknown): obj is T {\n return (typeof obj === \"object\" \|\| typeof obj === \"function\") && !isNil(obj);\n}\n\n/\n Check if a value is a function\n \n @param obj - The value to check\n * @returns True if the value is a function, false otherwise\n /\nexport function isFunction<T extends AnyFunction>(obj: unknown): obj is T {\n return typeof obj === \"function\";\n}\n\n/\n Check if an object is a plain object (i.e. a JS object but not including arrays or functions)\n \n @param obj - The object to check\n * @returns True if the object is a plain object, false otherwise.\n /\nexport function isPlainObject<T extends PlainObject>(obj: unknown): obj is T {\n if (!isObject(obj)) {\n return false;\n }\n\n const prototype = Object.getPrototypeOf(obj);\n return prototype === Object.prototype \|\| prototype === null;\n}\n\n/\n Check if an object is an empty object\n \n @param obj - The object to check\n * @returns True if the object is an empty object, false otherwise\n /\nexport function isEmptyObject(obj: unknown): obj is EmptyObject {\n if (!isObject(obj)) {\n return false;\n }\n\n // Check for own string and symbol properties (enumerable or not)\n if (Object.getOwnPropertyNames(obj).length > 0 \|\| Object.getOwnPropertySymbols(obj).length > 0) {\n return false;\n }\n\n return true;\n}\n","import type { SetRequired } from \"type-fest\";\nimport { devLogger } from \"../dev\";\nimport type { PlainObject } from \"../types\";\nimport { isObject } from \"./lang\";\n\n/\n Deep clone an object using JSON serialization with fallback to shallow clone\n \n @param obj - The object to clone\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n /\nexport function deepClone<T>(obj: T): T {\n try {\n return JSON.parse(JSON.stringify(obj));\n } catch (error) {\n devLogger.warn(\"Failed to deep clone object, using shallow clone:\", error);\n // Fallback to shallow clone for primitive types and simple objects\n if (obj === null \|\| typeof obj !== \"object\") {\n return obj;\n }\n return { ...obj } as T;\n }\n}\n\n/\n Check if an object has a key\n \n @param obj - The object to check\n * @param key - The key to check\n * @returns True if the object has the key, false otherwise\n */\nexport function hasKey<T extends PlainObject, K extends string>(\n obj: T,\n key: K,\n): obj is T & SetRequired<T, K> {\n return isObject(obj) && key in obj;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYO,SAAS,gBAAgB,SAA4B;AAC1D,QAAM,QACJ,QAAO,mCAAS,SAAQ,aAAa,QAAQ,MAAM,MAAG;AAd1D;AAc6D,oDAAS,QAAT,YAAgB,aAAa;AAAA;AAExF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAcL,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,OAAO,wBAAC,YAAkB,SAAgB;AACxC,UAAI,MAAM,GAAG;AACX,gBAAQ,MAAM,gBAAgB,OAAO,GAAG,SAAS,GAAG,IAAI;AAAA,MAC1D;AAAA,IACF,GAJO;AAAA,IAMP,OAAO,wBAAC,aAAmB,UAAiB;AAE1C;AAAA,IACF,GAHO;AAAA,EAIT;AACF;AAjEgB;AAmEhB,IAAO,iBAAQ,gBAAgB;AAE/B,SAAS,eAAe;AACtB,QAAM,UAAU,QAAQ,IAAI;AAC5B,SAAO,YAAY,gBAAgB,YAAY,UAAU,YAAY;AACvE;AAHS;AAKT,SAAS,gBAAgB,OAAoD;AAC3E,SAAO,gBAAgB,UAAU,CAAC,KAAK,KAAK;AAC9C;AAFS;AAIT,SAAS,YAAoB;AAC3B,UAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE;AAC/D;AAFS;;;ACrFT,SAAsB,6BAAgC,QAAyC;AAAA;AAC7F,UAAM,SAAS,OAAO,UAAU;AAChC,UAAM,SAAc,CAAC;AAErB,WAAO,MAAM;AACX,YAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,UAAI,KAAM;AACV,aAAO,KAAK,KAAK;AAAA,IACnB;AAEA,WAAO;AAAA,EACT;AAAA;AAXsB;AAkBf,SAAS,4BAA+B,QAA+B;AAC5E,SAAO;AAAA,IACL,CAAQ,OAAO,aAAa,IAAI;AAAA;AAC9B,mBAAW,SAAS,QAAQ;AAC1B,gBAAM;AAAA,QACR;AAAA,MACF;AAAA;AAAA,EACF;AACF;AARgB;AAehB,SAAsB,4BAA+B,UAA0C;AAAA;AAC7F,UAAM,SAAc,CAAC;AACrB;AAAA,iCAAyB,WAAzB,0EAAmC;AAAxB,cAAM,OAAjB;AACE,eAAO,KAAK,IAAI;AAAA,MAClB;AAAA,aAFA,MAxCF;AAwCE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,WAAO;AAAA,EACT;AAAA;AANsB;AAaf,SAAS,6BAAgC,QAAgC;AAC9E,SAAO,IAAI,eAAe;AAAA,IACxB,MAAM,YAAY;AAChB,UAAI;AACF,mBAAW,SAAS,QAAQ;AAC1B,qBAAW,QAAQ,KAAK;AAAA,QAC1B;AAAA,MACF,UAAE;AACA,mBAAW,MAAM;AAAA,MACnB;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAZgB;AAmBhB,SAAsB,6BAA6B,UAAuC;AAAA;AAExF,WAAO,6BAA6B,SAAS,KAAM,YAAY,IAAI,kBAAkB,CAAC,CAAC;AAAA,EACzF;AAAA;AAHsB;;;AC7Df,SAAS,MAAM,KAA0B;AAC9C,SAAO,QAAQ,QAAQ,QAAQ;AACjC;AAFgB;AAUT,SAAS,SAA2B,KAAwB;AACjE,UAAQ,OAAO,QAAQ,YAAY,OAAO,QAAQ,eAAe,CAAC,MAAM,GAAG;AAC7E;AAFgB;AAUT,SAAS,WAAkC,KAAwB;AACxE,SAAO,OAAO,QAAQ;AACxB;AAFgB;AAUT,SAAS,cAAqC,KAAwB;AAC3E,MAAI,CAAC,SAAS,GAAG,GAAG;AAClB,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,OAAO,eAAe,GAAG;AAC3C,SAAO,cAAc,OAAO,aAAa,cAAc;AACzD;AAPgB;AAeT,SAAS,cAAc,KAAkC;AAC9D,MAAI,CAAC,SAAS,GAAG,GAAG;AAClB,WAAO;AAAA,EACT;AAGA,MAAI,OAAO,oBAAoB,GAAG,EAAE,SAAS,KAAK,OAAO,sBAAsB,GAAG,EAAE,SAAS,GAAG;AAC9F,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAXgB;;;AC3CT,SAAS,UAAa,KAAW;AACtC,MAAI;AACF,WAAO,KAAK,MAAM,KAAK,UAAU,GAAG,CAAC;AAAA,EACvC,SAAS,OAAO;AACd,mBAAU,KAAK,qDAAqD,KAAK;AAEzE,QAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAC3C,aAAO;AAAA,IACT;AACA,WAAO,mBAAK;AAAA,EACd;AACF;AAXgB;AAoBT,SAAS,OACd,KACA,KAC8B;AAC9B,SAAO,SAAS,GAAG,KAAK,OAAO;AACjC;AALgB;","names":[]}

package/dist/types/index.d.mts ADDED Viewed

@@ -0,0 +1,29 @@
+/**
+ * This type is used to allow any type and bypass restrictions used in
+ * typechecking and linting. Provides a CLEAR warning this is NOT the desired
+ * behavior and is a dangerous practice.
+ */
+type DangerouslyAllowAny = any;
+/**
+ * A plain object is an object that has no special properties or methods,
+ * and just has properties that are strings, numbers, or symbols.
+ */
+type PlainObject = Record<string | number | symbol, unknown>;
+/**
+ * A nil value is a value that is not defined or is undefined.
+ */
+type Nil = null | undefined;
+/**
+ * A type that represents any async function.
+ */
+type AnyAsyncFunction = (...args: unknown[]) => Promise<unknown>;
+/**
+ * A type that represents any synchronous function.
+ */
+type AnySyncFunction = (...args: unknown[]) => unknown;
+/**
+ * A type that represents any function.
+ */
+type AnyFunction = AnyAsyncFunction | AnySyncFunction;
+export type { AnyAsyncFunction, AnyFunction, AnySyncFunction, DangerouslyAllowAny, Nil, PlainObject };

package/dist/types/index.d.ts ADDED Viewed

@@ -0,0 +1,29 @@
+/**
+ * This type is used to allow any type and bypass restrictions used in
+ * typechecking and linting. Provides a CLEAR warning this is NOT the desired
+ * behavior and is a dangerous practice.
+ */
+type DangerouslyAllowAny = any;
+/**
+ * A plain object is an object that has no special properties or methods,
+ * and just has properties that are strings, numbers, or symbols.
+ */
+type PlainObject = Record<string | number | symbol, unknown>;
+/**
+ * A nil value is a value that is not defined or is undefined.
+ */
+type Nil = null | undefined;
+/**
+ * A type that represents any async function.
+ */
+type AnyAsyncFunction = (...args: unknown[]) => Promise<unknown>;
+/**
+ * A type that represents any synchronous function.
+ */
+type AnySyncFunction = (...args: unknown[]) => unknown;
+/**
+ * A type that represents any function.
+ */
+type AnyFunction = AnyAsyncFunction | AnySyncFunction;
+export type { AnyAsyncFunction, AnyFunction, AnySyncFunction, DangerouslyAllowAny, Nil, PlainObject };

package/dist/utils/index.d.mts CHANGED Viewed

@@ -1,6 +1,27 @@
+import { SetRequired, EmptyObject } from 'type-fest';
+/**
+ * A plain object is an object that has no special properties or methods,
+ * and just has properties that are strings, numbers, or symbols.
+ */
+type PlainObject = Record<string | number | symbol, unknown>;
+/**
+ * A nil value is a value that is not defined or is undefined.
+ */
+type Nil = null | undefined;
+/**
+ * A type that represents any async function.
+ */
+type AnyAsyncFunction = (...args: unknown[]) => Promise<unknown>;
 /**
- * Object manipulation utility functions
+ * A type that represents any synchronous function.
  */
+type AnySyncFunction = (...args: unknown[]) => unknown;
+/**
+ * A type that represents any function.
+ */
+type AnyFunction = AnyAsyncFunction | AnySyncFunction;
 /**
  * Deep clone an object using JSON serialization with fallback to shallow clone
  *
@@ -8,5 +29,49 @@
  * @returns A deep copy of the object, or shallow copy if JSON serialization fails
  */
 declare function deepClone<T>(obj: T): T;
+/**
+ * Check if an object has a key
+ *
+ * @param obj - The object to check
+ * @param key - The key to check
+ * @returns True if the object has the key, false otherwise
+ */
+declare function hasKey<T extends PlainObject, K extends string>(obj: T, key: K): obj is T & SetRequired<T, K>;
+/**
+ * Check if a value is nil
+ *
+ * @param obj - The value to check
+ * @returns True if the value is nil, false otherwise
+ */
+declare function isNil(obj: unknown): obj is Nil;
+/**
+ * Check if an object is a JS object
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a JS object}
+ */
+declare function isObject<T extends object>(obj: unknown): obj is T;
+/**
+ * Check if a value is a function
+ *
+ * @param obj - The value to check
+ * @returns True if the value is a function, false otherwise
+ */
+declare function isFunction<T extends AnyFunction>(obj: unknown): obj is T;
+/**
+ * Check if an object is a plain object (i.e. a JS object but not including arrays or functions)
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a plain object, false otherwise.
+ */
+declare function isPlainObject<T extends PlainObject>(obj: unknown): obj is T;
+/**
+ * Check if an object is an empty object
+ *
+ * @param obj - The object to check
+ * @returns True if the object is an empty object, false otherwise
+ */
+declare function isEmptyObject(obj: unknown): obj is EmptyObject;
-export { deepClone };
+export { deepClone, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject };

package/dist/utils/index.d.ts CHANGED Viewed

@@ -1,6 +1,27 @@
+import { SetRequired, EmptyObject } from 'type-fest';
+/**
+ * A plain object is an object that has no special properties or methods,
+ * and just has properties that are strings, numbers, or symbols.
+ */
+type PlainObject = Record<string | number | symbol, unknown>;
+/**
+ * A nil value is a value that is not defined or is undefined.
+ */
+type Nil = null | undefined;
+/**
+ * A type that represents any async function.
+ */
+type AnyAsyncFunction = (...args: unknown[]) => Promise<unknown>;
 /**
- * Object manipulation utility functions
+ * A type that represents any synchronous function.
  */
+type AnySyncFunction = (...args: unknown[]) => unknown;
+/**
+ * A type that represents any function.
+ */
+type AnyFunction = AnyAsyncFunction | AnySyncFunction;
 /**
  * Deep clone an object using JSON serialization with fallback to shallow clone
  *
@@ -8,5 +29,49 @@
  * @returns A deep copy of the object, or shallow copy if JSON serialization fails
  */
 declare function deepClone<T>(obj: T): T;
+/**
+ * Check if an object has a key
+ *
+ * @param obj - The object to check
+ * @param key - The key to check
+ * @returns True if the object has the key, false otherwise
+ */
+declare function hasKey<T extends PlainObject, K extends string>(obj: T, key: K): obj is T & SetRequired<T, K>;
+/**
+ * Check if a value is nil
+ *
+ * @param obj - The value to check
+ * @returns True if the value is nil, false otherwise
+ */
+declare function isNil(obj: unknown): obj is Nil;
+/**
+ * Check if an object is a JS object
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a JS object}
+ */
+declare function isObject<T extends object>(obj: unknown): obj is T;
+/**
+ * Check if a value is a function
+ *
+ * @param obj - The value to check
+ * @returns True if the value is a function, false otherwise
+ */
+declare function isFunction<T extends AnyFunction>(obj: unknown): obj is T;
+/**
+ * Check if an object is a plain object (i.e. a JS object but not including arrays or functions)
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a plain object, false otherwise.
+ */
+declare function isPlainObject<T extends PlainObject>(obj: unknown): obj is T;
+/**
+ * Check if an object is an empty object
+ *
+ * @param obj - The object to check
+ * @returns True if the object is an empty object, false otherwise
+ */
+declare function isEmptyObject(obj: unknown): obj is EmptyObject;
-export { deepClone };
+export { deepClone, hasKey, isEmptyObject, isFunction, isNil, isObject, isPlainObject };

package/dist/utils/index.js CHANGED Viewed

@@ -35,7 +35,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/utils/index.ts
 var index_exports = {};
 __export(index_exports, {
-  deepClone: () => deepClone
+  deepClone: () => deepClone,
+  hasKey: () => hasKey,
+  isEmptyObject: () => isEmptyObject,
+  isFunction: () => isFunction,
+  isNil: () => isNil,
+  isObject: () => isObject,
+  isPlainObject: () => isPlainObject
 });
 module.exports = __toCommonJS(index_exports);
@@ -99,13 +105,17 @@ function createDevLogger(options) {
       if (isDev()) {
         console.error(formatLogPrefix("ERROR"), message, ...args);
       }
-    }, "error")
+    }, "error"),
+    debug: /* @__PURE__ */ __name((_message, ..._args) => {
+      return;
+    }, "debug")
   };
 }
 __name(createDevLogger, "createDevLogger");
 var logger_default = createDevLogger();
 function isDevNodeEnv() {
-  return process.env.NODE_ENV === "development";
+  const nodeEnv = process.env.NODE_ENV;
+  return nodeEnv !== "production" && nodeEnv !== "test" && nodeEnv !== "ci";
 }
 __name(isDevNodeEnv, "isDevNodeEnv");
 function formatLogPrefix(level) {
@@ -117,7 +127,39 @@ function timestamp() {
 }
 __name(timestamp, "timestamp");
-// src/utils/object-utils.ts
+// src/utils/lang.ts
+function isNil(obj) {
+  return obj === null || obj === void 0;
+}
+__name(isNil, "isNil");
+function isObject(obj) {
+  return (typeof obj === "object" || typeof obj === "function") && !isNil(obj);
+}
+__name(isObject, "isObject");
+function isFunction(obj) {
+  return typeof obj === "function";
+}
+__name(isFunction, "isFunction");
+function isPlainObject(obj) {
+  if (!isObject(obj)) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(obj);
+  return prototype === Object.prototype || prototype === null;
+}
+__name(isPlainObject, "isPlainObject");
+function isEmptyObject(obj) {
+  if (!isObject(obj)) {
+    return false;
+  }
+  if (Object.getOwnPropertyNames(obj).length > 0 || Object.getOwnPropertySymbols(obj).length > 0) {
+    return false;
+  }
+  return true;
+}
+__name(isEmptyObject, "isEmptyObject");
+// src/utils/objects.ts
 function deepClone(obj) {
   try {
     return JSON.parse(JSON.stringify(obj));
@@ -130,8 +172,18 @@ function deepClone(obj) {
   }
 }
 __name(deepClone, "deepClone");
+function hasKey(obj, key) {
+  return isObject(obj) && key in obj;
+}
+__name(hasKey, "hasKey");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  deepClone
+  deepClone,
+  hasKey,
+  isEmptyObject,
+  isFunction,
+  isNil,
+  isObject,
+  isPlainObject
 });
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/utils/index.ts","../../src/dev/logger.ts","../../src/utils/~~object-~~utils.ts"],"sourcesContent":["export { deepClone } from \"./~~object-utils~~\";\n","export interface DevLoggerOptions {\n dev: boolean \| (() => boolean);\n}\n\n/*\n A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n /\nexport function createDevLogger(options?: DevLoggerOptions) {\n const isDev =\n typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n return {\n /\n Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n info: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.info(formatLogPrefix(\"INFO\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.warn(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n warn: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development.\n \n @example\n * ```typescript\n * devLogger.error(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n error: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n }\n },\n };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n ~~return~~ process.env.NODE_ENV ~~===~~ \"~~development~~\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" \| \"WARN\" \| \"ERROR\"): string {\n return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n","/\n ~~Object~~ ~~manipulation~~ ~~utility~~ functions\n /\n\nimport { devLogger } from \"../dev\";\n\n/\n Deep clone an object using JSON serialization with fallback to shallow clone\n \n @param obj - The object to clone\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n */\nexport function deepClone<T>(obj: T): T {\n try {\n return JSON.parse(JSON.stringify(obj));\n } catch (error) {\n devLogger.warn(\"Failed to deep clone object, using shallow clone:\", error);\n // Fallback to shallow clone for primitive types and simple objects\n if (obj === null \|\| typeof obj !== \"object\") {\n return obj;\n }\n return { ...obj } as T;\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACYO,SAAS,gBAAgB,SAA4B;AAC1D,QAAM,QACJ,QAAO,mCAAS,SAAQ,aAAa,QAAQ,MAAM,MAAG;AAd1D;AAc6D,oDAAS,QAAT,YAAgB,aAAa;AAAA;AAExF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAcL,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,OAAO,wBAAC,YAAkB,SAAgB;AACxC,UAAI,MAAM,GAAG;AACX,gBAAQ,MAAM,gBAAgB,OAAO,GAAG,SAAS,GAAG,IAAI;AAAA,MAC1D;AAAA,IACF,GAJO;AAAA,~~EAKT~~;AACF;~~AA5DgB~~;~~AA8DhB~~,IAAO,iBAAQ,gBAAgB;AAE/B,SAAS,eAAe;AACtB,~~SAAO~~,QAAQ,IAAI,~~aAAa~~;~~AAClC~~;~~AAFS~~;~~AAIT~~,SAAS,gBAAgB,~~OAA0C~~;~~AACjE~~,SAAO,gBAAgB,UAAU,CAAC,KAAK,KAAK;AAC9C;AAFS;AAIT,SAAS,YAAoB;AAC3B,UAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE;AAC/D;AAFS;;;~~ACxEF~~,SAAS,UAAa,KAAW;AACtC,MAAI;AACF,WAAO,KAAK,MAAM,KAAK,UAAU,GAAG,CAAC;AAAA,EACvC,SAAS,OAAO;AACd,mBAAU,KAAK,qDAAqD,KAAK;AAEzE,QAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAC3C,aAAO;AAAA,IACT;AACA,WAAO,mBAAK;AAAA,EACd;AACF;AAXgB;","names":[]}
1	+ {"version":3,"sources":["../../src/utils/index.ts","../../src/dev/logger.ts","../../src/utils/lang.ts","../../src/utils/objects.ts"],"sourcesContent":["export { deepClone, hasKey } from \"./objects\";\nexport { isNil, isObject, isEmptyObject, isFunction, isPlainObject } from \"./lang\";\n","export interface DevLoggerOptions {\n dev: boolean \| (() => boolean);\n}\n\n/*\n A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n /\nexport function createDevLogger(options?: DevLoggerOptions) {\n const isDev =\n typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n return {\n /\n Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n info: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.info(formatLogPrefix(\"INFO\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.warn(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n warn: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development.\n \n @example\n * ```typescript\n * devLogger.error(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n error: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n }\n },\n\n debug: (_message?: any, ..._args: any[]) => {\n // todo: implement debug logging with pino\n return;\n },\n };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n const nodeEnv = process.env.NODE_ENV;\n return nodeEnv !== \"production\" && nodeEnv !== \"test\" && nodeEnv !== \"ci\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" \| \"WARN\" \| \"ERROR\" \| \"DEBUG\"): string {\n return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n","import type { EmptyObject } from \"type-fest\";\nimport type { AnyFunction, Nil, PlainObject } from \"../types\";\n\n/\n Check if a value is nil\n \n @param obj - The value to check\n * @returns True if the value is nil, false otherwise\n /\nexport function isNil(obj: unknown): obj is Nil {\n return obj === null \|\| obj === undefined;\n}\n\n/\n Check if an object is a JS object\n \n @param obj - The object to check\n * @returns True if the object is a JS object}\n /\nexport function isObject<T extends object>(obj: unknown): obj is T {\n return (typeof obj === \"object\" \|\| typeof obj === \"function\") && !isNil(obj);\n}\n\n/\n Check if a value is a function\n \n @param obj - The value to check\n * @returns True if the value is a function, false otherwise\n /\nexport function isFunction<T extends AnyFunction>(obj: unknown): obj is T {\n return typeof obj === \"function\";\n}\n\n/\n Check if an object is a plain object (i.e. a JS object but not including arrays or functions)\n \n @param obj - The object to check\n * @returns True if the object is a plain object, false otherwise.\n /\nexport function isPlainObject<T extends PlainObject>(obj: unknown): obj is T {\n if (!isObject(obj)) {\n return false;\n }\n\n const prototype = Object.getPrototypeOf(obj);\n return prototype === Object.prototype \|\| prototype === null;\n}\n\n/\n Check if an object is an empty object\n \n @param obj - The object to check\n * @returns True if the object is an empty object, false otherwise\n /\nexport function isEmptyObject(obj: unknown): obj is EmptyObject {\n if (!isObject(obj)) {\n return false;\n }\n\n // Check for own string and symbol properties (enumerable or not)\n if (Object.getOwnPropertyNames(obj).length > 0 \|\| Object.getOwnPropertySymbols(obj).length > 0) {\n return false;\n }\n\n return true;\n}\n","import type { SetRequired } from \"type-fest\";\nimport { devLogger } from \"../dev\";\nimport type { PlainObject } from \"../types\";\nimport { isObject } from \"./lang\";\n\n/\n Deep clone an object using JSON serialization with fallback to shallow clone\n \n @param obj - The object to clone\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n /\nexport function deepClone<T>(obj: T): T {\n try {\n return JSON.parse(JSON.stringify(obj));\n } catch (error) {\n devLogger.warn(\"Failed to deep clone object, using shallow clone:\", error);\n // Fallback to shallow clone for primitive types and simple objects\n if (obj === null \|\| typeof obj !== \"object\") {\n return obj;\n }\n return { ...obj } as T;\n }\n}\n\n/\n Check if an object has a key\n \n @param obj - The object to check\n * @param key - The key to check\n * @returns True if the object has the key, false otherwise\n */\nexport function hasKey<T extends PlainObject, K extends string>(\n obj: T,\n key: K,\n): obj is T & SetRequired<T, K> {\n return isObject(obj) && key in obj;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACYO,SAAS,gBAAgB,SAA4B;AAC1D,QAAM,QACJ,QAAO,mCAAS,SAAQ,aAAa,QAAQ,MAAM,MAAG;AAd1D;AAc6D,oDAAS,QAAT,YAAgB,aAAa;AAAA;AAExF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAcL,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,OAAO,wBAAC,YAAkB,SAAgB;AACxC,UAAI,MAAM,GAAG;AACX,gBAAQ,MAAM,gBAAgB,OAAO,GAAG,SAAS,GAAG,IAAI;AAAA,MAC1D;AAAA,IACF,GAJO;AAAA,IAMP,OAAO,wBAAC,aAAmB,UAAiB;AAE1C;AAAA,IACF,GAHO;AAAA,EAIT;AACF;AAjEgB;AAmEhB,IAAO,iBAAQ,gBAAgB;AAE/B,SAAS,eAAe;AACtB,QAAM,UAAU,QAAQ,IAAI;AAC5B,SAAO,YAAY,gBAAgB,YAAY,UAAU,YAAY;AACvE;AAHS;AAKT,SAAS,gBAAgB,OAAoD;AAC3E,SAAO,gBAAgB,UAAU,CAAC,KAAK,KAAK;AAC9C;AAFS;AAIT,SAAS,YAAoB;AAC3B,UAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE;AAC/D;AAFS;;;ACjFF,SAAS,MAAM,KAA0B;AAC9C,SAAO,QAAQ,QAAQ,QAAQ;AACjC;AAFgB;AAUT,SAAS,SAA2B,KAAwB;AACjE,UAAQ,OAAO,QAAQ,YAAY,OAAO,QAAQ,eAAe,CAAC,MAAM,GAAG;AAC7E;AAFgB;AAUT,SAAS,WAAkC,KAAwB;AACxE,SAAO,OAAO,QAAQ;AACxB;AAFgB;AAUT,SAAS,cAAqC,KAAwB;AAC3E,MAAI,CAAC,SAAS,GAAG,GAAG;AAClB,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,OAAO,eAAe,GAAG;AAC3C,SAAO,cAAc,OAAO,aAAa,cAAc;AACzD;AAPgB;AAeT,SAAS,cAAc,KAAkC;AAC9D,MAAI,CAAC,SAAS,GAAG,GAAG;AAClB,WAAO;AAAA,EACT;AAGA,MAAI,OAAO,oBAAoB,GAAG,EAAE,SAAS,KAAK,OAAO,sBAAsB,GAAG,EAAE,SAAS,GAAG;AAC9F,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAXgB;;;AC3CT,SAAS,UAAa,KAAW;AACtC,MAAI;AACF,WAAO,KAAK,MAAM,KAAK,UAAU,GAAG,CAAC;AAAA,EACvC,SAAS,OAAO;AACd,mBAAU,KAAK,qDAAqD,KAAK;AAEzE,QAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAC3C,aAAO;AAAA,IACT;AACA,WAAO,mBAAK;AAAA,EACd;AACF;AAXgB;AAoBT,SAAS,OACd,KACA,KAC8B;AAC9B,SAAO,SAAS,GAAG,KAAK,OAAO;AACjC;AALgB;","names":[]}

package/dist/utils/index.mjs CHANGED Viewed

@@ -76,13 +76,17 @@ function createDevLogger(options) {
       if (isDev()) {
         console.error(formatLogPrefix("ERROR"), message, ...args);
       }
-    }, "error")
+    }, "error"),
+    debug: /* @__PURE__ */ __name((_message, ..._args) => {
+      return;
+    }, "debug")
   };
 }
 __name(createDevLogger, "createDevLogger");
 var logger_default = createDevLogger();
 function isDevNodeEnv() {
-  return process.env.NODE_ENV === "development";
+  const nodeEnv = process.env.NODE_ENV;
+  return nodeEnv !== "production" && nodeEnv !== "test" && nodeEnv !== "ci";
 }
 __name(isDevNodeEnv, "isDevNodeEnv");
 function formatLogPrefix(level) {
@@ -94,7 +98,39 @@ function timestamp() {
 }
 __name(timestamp, "timestamp");
-// src/utils/object-utils.ts
+// src/utils/lang.ts
+function isNil(obj) {
+  return obj === null || obj === void 0;
+}
+__name(isNil, "isNil");
+function isObject(obj) {
+  return (typeof obj === "object" || typeof obj === "function") && !isNil(obj);
+}
+__name(isObject, "isObject");
+function isFunction(obj) {
+  return typeof obj === "function";
+}
+__name(isFunction, "isFunction");
+function isPlainObject(obj) {
+  if (!isObject(obj)) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(obj);
+  return prototype === Object.prototype || prototype === null;
+}
+__name(isPlainObject, "isPlainObject");
+function isEmptyObject(obj) {
+  if (!isObject(obj)) {
+    return false;
+  }
+  if (Object.getOwnPropertyNames(obj).length > 0 || Object.getOwnPropertySymbols(obj).length > 0) {
+    return false;
+  }
+  return true;
+}
+__name(isEmptyObject, "isEmptyObject");
+// src/utils/objects.ts
 function deepClone(obj) {
   try {
     return JSON.parse(JSON.stringify(obj));
@@ -107,7 +143,17 @@ function deepClone(obj) {
   }
 }
 __name(deepClone, "deepClone");
+function hasKey(obj, key) {
+  return isObject(obj) && key in obj;
+}
+__name(hasKey, "hasKey");
 export {
-  deepClone
+  deepClone,
+  hasKey,
+  isEmptyObject,
+  isFunction,
+  isNil,
+  isObject,
+  isPlainObject
 };
 //# sourceMappingURL=index.mjs.map

package/dist/utils/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/dev/logger.ts","../../src/utils/~~object-~~utils.ts"],"sourcesContent":["export interface DevLoggerOptions {\n dev: boolean \| (() => boolean);\n}\n\n/*\n A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n /\nexport function createDevLogger(options?: DevLoggerOptions) {\n const isDev =\n typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n return {\n /\n Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n info: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.info(formatLogPrefix(\"INFO\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.warn(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n warn: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development.\n \n @example\n * ```typescript\n * devLogger.error(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n error: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n }\n },\n };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n ~~return~~ process.env.NODE_ENV ~~===~~ \"~~development~~\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" \| \"WARN\" \| \"ERROR\"): string {\n return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n","/\n ~~Object~~ ~~manipulation~~ ~~utility~~ functions\n /\n\nimport { devLogger } from \"../dev\";\n\n/\n Deep clone an object using JSON serialization with fallback to shallow clone\n \n @param obj - The object to clone\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n */\nexport function deepClone<T>(obj: T): T {\n try {\n return JSON.parse(JSON.stringify(obj));\n } catch (error) {\n devLogger.warn(\"Failed to deep clone object, using shallow clone:\", error);\n // Fallback to shallow clone for primitive types and simple objects\n if (obj === null \|\| typeof obj !== \"object\") {\n return obj;\n }\n return { ...obj } as T;\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAYO,SAAS,gBAAgB,SAA4B;AAC1D,QAAM,QACJ,QAAO,mCAAS,SAAQ,aAAa,QAAQ,MAAM,MAAG;AAd1D;AAc6D,oDAAS,QAAT,YAAgB,aAAa;AAAA;AAExF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAcL,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,OAAO,wBAAC,YAAkB,SAAgB;AACxC,UAAI,MAAM,GAAG;AACX,gBAAQ,MAAM,gBAAgB,OAAO,GAAG,SAAS,GAAG,IAAI;AAAA,MAC1D;AAAA,IACF,GAJO;AAAA,~~EAKT~~;AACF;~~AA5DgB~~;~~AA8DhB~~,IAAO,iBAAQ,gBAAgB;AAE/B,SAAS,eAAe;AACtB,~~SAAO~~,QAAQ,IAAI,~~aAAa~~;~~AAClC~~;~~AAFS~~;~~AAIT~~,SAAS,gBAAgB,~~OAA0C~~;~~AACjE~~,SAAO,gBAAgB,UAAU,CAAC,KAAK,KAAK;AAC9C;AAFS;AAIT,SAAS,YAAoB;AAC3B,UAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE;AAC/D;AAFS;;;~~ACxEF~~,SAAS,UAAa,KAAW;AACtC,MAAI;AACF,WAAO,KAAK,MAAM,KAAK,UAAU,GAAG,CAAC;AAAA,EACvC,SAAS,OAAO;AACd,mBAAU,KAAK,qDAAqD,KAAK;AAEzE,QAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAC3C,aAAO;AAAA,IACT;AACA,WAAO,mBAAK;AAAA,EACd;AACF;AAXgB;","names":[]}
1	+ {"version":3,"sources":["../../src/dev/logger.ts","../../src/utils/lang.ts","../../src/utils/objects.ts"],"sourcesContent":["export interface DevLoggerOptions {\n dev: boolean \| (() => boolean);\n}\n\n/*\n A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n /\nexport function createDevLogger(options?: DevLoggerOptions) {\n const isDev =\n typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n return {\n /\n Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n info: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.info(formatLogPrefix(\"INFO\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n \n @example\n * ```typescript\n * devLogger.warn(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n warn: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n }\n },\n /\n Log a warning message to the console if the environment is development.\n \n @example\n * ```typescript\n * devLogger.error(\"Hello, world!\");\n \n // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n * ```\n \n @param message - The message to log.\n * @param args - The arguments to log.\n /\n error: (message?: any, ...args: any[]) => {\n if (isDev()) {\n console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n }\n },\n\n debug: (_message?: any, ..._args: any[]) => {\n // todo: implement debug logging with pino\n return;\n },\n };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n const nodeEnv = process.env.NODE_ENV;\n return nodeEnv !== \"production\" && nodeEnv !== \"test\" && nodeEnv !== \"ci\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" \| \"WARN\" \| \"ERROR\" \| \"DEBUG\"): string {\n return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n","import type { EmptyObject } from \"type-fest\";\nimport type { AnyFunction, Nil, PlainObject } from \"../types\";\n\n/\n Check if a value is nil\n \n @param obj - The value to check\n * @returns True if the value is nil, false otherwise\n /\nexport function isNil(obj: unknown): obj is Nil {\n return obj === null \|\| obj === undefined;\n}\n\n/\n Check if an object is a JS object\n \n @param obj - The object to check\n * @returns True if the object is a JS object}\n /\nexport function isObject<T extends object>(obj: unknown): obj is T {\n return (typeof obj === \"object\" \|\| typeof obj === \"function\") && !isNil(obj);\n}\n\n/\n Check if a value is a function\n \n @param obj - The value to check\n * @returns True if the value is a function, false otherwise\n /\nexport function isFunction<T extends AnyFunction>(obj: unknown): obj is T {\n return typeof obj === \"function\";\n}\n\n/\n Check if an object is a plain object (i.e. a JS object but not including arrays or functions)\n \n @param obj - The object to check\n * @returns True if the object is a plain object, false otherwise.\n /\nexport function isPlainObject<T extends PlainObject>(obj: unknown): obj is T {\n if (!isObject(obj)) {\n return false;\n }\n\n const prototype = Object.getPrototypeOf(obj);\n return prototype === Object.prototype \|\| prototype === null;\n}\n\n/\n Check if an object is an empty object\n \n @param obj - The object to check\n * @returns True if the object is an empty object, false otherwise\n /\nexport function isEmptyObject(obj: unknown): obj is EmptyObject {\n if (!isObject(obj)) {\n return false;\n }\n\n // Check for own string and symbol properties (enumerable or not)\n if (Object.getOwnPropertyNames(obj).length > 0 \|\| Object.getOwnPropertySymbols(obj).length > 0) {\n return false;\n }\n\n return true;\n}\n","import type { SetRequired } from \"type-fest\";\nimport { devLogger } from \"../dev\";\nimport type { PlainObject } from \"../types\";\nimport { isObject } from \"./lang\";\n\n/\n Deep clone an object using JSON serialization with fallback to shallow clone\n \n @param obj - The object to clone\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n /\nexport function deepClone<T>(obj: T): T {\n try {\n return JSON.parse(JSON.stringify(obj));\n } catch (error) {\n devLogger.warn(\"Failed to deep clone object, using shallow clone:\", error);\n // Fallback to shallow clone for primitive types and simple objects\n if (obj === null \|\| typeof obj !== \"object\") {\n return obj;\n }\n return { ...obj } as T;\n }\n}\n\n/\n Check if an object has a key\n \n @param obj - The object to check\n * @param key - The key to check\n * @returns True if the object has the key, false otherwise\n */\nexport function hasKey<T extends PlainObject, K extends string>(\n obj: T,\n key: K,\n): obj is T & SetRequired<T, K> {\n return isObject(obj) && key in obj;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAYO,SAAS,gBAAgB,SAA4B;AAC1D,QAAM,QACJ,QAAO,mCAAS,SAAQ,aAAa,QAAQ,MAAM,MAAG;AAd1D;AAc6D,oDAAS,QAAT,YAAgB,aAAa;AAAA;AAExF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAcL,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,OAAO,wBAAC,YAAkB,SAAgB;AACxC,UAAI,MAAM,GAAG;AACX,gBAAQ,MAAM,gBAAgB,OAAO,GAAG,SAAS,GAAG,IAAI;AAAA,MAC1D;AAAA,IACF,GAJO;AAAA,IAMP,OAAO,wBAAC,aAAmB,UAAiB;AAE1C;AAAA,IACF,GAHO;AAAA,EAIT;AACF;AAjEgB;AAmEhB,IAAO,iBAAQ,gBAAgB;AAE/B,SAAS,eAAe;AACtB,QAAM,UAAU,QAAQ,IAAI;AAC5B,SAAO,YAAY,gBAAgB,YAAY,UAAU,YAAY;AACvE;AAHS;AAKT,SAAS,gBAAgB,OAAoD;AAC3E,SAAO,gBAAgB,UAAU,CAAC,KAAK,KAAK;AAC9C;AAFS;AAIT,SAAS,YAAoB;AAC3B,UAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE;AAC/D;AAFS;;;ACjFF,SAAS,MAAM,KAA0B;AAC9C,SAAO,QAAQ,QAAQ,QAAQ;AACjC;AAFgB;AAUT,SAAS,SAA2B,KAAwB;AACjE,UAAQ,OAAO,QAAQ,YAAY,OAAO,QAAQ,eAAe,CAAC,MAAM,GAAG;AAC7E;AAFgB;AAUT,SAAS,WAAkC,KAAwB;AACxE,SAAO,OAAO,QAAQ;AACxB;AAFgB;AAUT,SAAS,cAAqC,KAAwB;AAC3E,MAAI,CAAC,SAAS,GAAG,GAAG;AAClB,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,OAAO,eAAe,GAAG;AAC3C,SAAO,cAAc,OAAO,aAAa,cAAc;AACzD;AAPgB;AAeT,SAAS,cAAc,KAAkC;AAC9D,MAAI,CAAC,SAAS,GAAG,GAAG;AAClB,WAAO;AAAA,EACT;AAGA,MAAI,OAAO,oBAAoB,GAAG,EAAE,SAAS,KAAK,OAAO,sBAAsB,GAAG,EAAE,SAAS,GAAG;AAC9F,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAXgB;;;AC3CT,SAAS,UAAa,KAAW;AACtC,MAAI;AACF,WAAO,KAAK,MAAM,KAAK,UAAU,GAAG,CAAC;AAAA,EACvC,SAAS,OAAO;AACd,mBAAU,KAAK,qDAAqD,KAAK;AAEzE,QAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAC3C,aAAO;AAAA,IACT;AACA,WAAO,mBAAK;AAAA,EACd;AACF;AAXgB;AAoBT,SAAS,OACd,KACA,KAC8B;AAC9B,SAAO,SAAS,GAAG,KAAK,OAAO;AACjC;AALgB;","names":[]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@voltagent/internal",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "VoltAgent internal - an internal set of tools for the VoltAgent packages",
   "license": "MIT",
   "exports": {
@@ -23,6 +23,9 @@
       "types": "./dist/utils/index.d.ts",
       "import": "./dist/utils/index.mjs",
       "require": "./dist/utils/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts"
     }
   },
   "main": "dist/main/index.js",
@@ -33,12 +36,11 @@
     "dev/dist/**/*",
     "test/dist/**/*"
   ],
-  "dependencies": {
-    "@voltagent/core": "^0.1.44"
-  },
   "devDependencies": {
     "@types/node": "^24.0.3",
+    "@vitest/coverage-v8": "^3.2.4",
     "tsup": "^8.5.0",
+    "type-fest": "^4.41.0",
     "typescript": "^5.0.4",
     "vitest": "^3.2.4"
   },