@prefactor/core 0.1.0

package/dist/utils/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/utils/logging.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,cAAM,MAAM;IAGE,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAA2B;gBAE3B,SAAS,EAAE,MAAM;IAErC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI;CASlE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAWvC"}

package/dist/utils/logging.js

@@ -0,0 +1,71 @@
+/**
+ * Log levels for the SDK
+ */
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+})(LogLevel || (LogLevel = {}));
+/**
+ * Logger class for the Prefactor SDK
+ */
+class Logger {
+    namespace;
+    static level = LogLevel.INFO;
+    constructor(namespace) {
+        this.namespace = namespace;
+    }
+    debug(message, ...args) {
+        if (Logger.level <= LogLevel.DEBUG) {
+            console.debug(`[prefactor:${this.namespace}] ${message}`, ...args);
+        }
+    }
+    info(message, ...args) {
+        if (Logger.level <= LogLevel.INFO) {
+            console.info(`[prefactor:${this.namespace}] ${message}`, ...args);
+        }
+    }
+    warn(message, ...args) {
+        if (Logger.level <= LogLevel.WARN) {
+            console.warn(`[prefactor:${this.namespace}] ${message}`, ...args);
+        }
+    }
+    error(message, ...args) {
+        if (Logger.level <= LogLevel.ERROR) {
+            console.error(`[prefactor:${this.namespace}] ${message}`, ...args);
+        }
+    }
+    /**
+     * Set the global log level
+     */
+    static setLevel(level) {
+        const levelMap = {
+            debug: LogLevel.DEBUG,
+            info: LogLevel.INFO,
+            warn: LogLevel.WARN,
+            error: LogLevel.ERROR,
+        };
+        Logger.level = levelMap[level];
+    }
+}
+/**
+ * Get a logger instance for a specific namespace
+ *
+ * @param namespace - The namespace for this logger
+ * @returns Logger instance
+ */
+export function getLogger(namespace) {
+    return new Logger(namespace);
+}
+/**
+ * Configure logging based on environment variables
+ */
+export function configureLogging() {
+    const level = process.env.PREFACTOR_LOG_LEVEL?.toLowerCase();
+    if (level) {
+        Logger.setLevel(level);
+    }
+}
+//# sourceMappingURL=logging.js.map

package/dist/utils/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/utils/logging.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,IAAK,QAKJ;AALD,WAAK,QAAQ;IACX,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;AACX,CAAC,EALI,QAAQ,KAAR,QAAQ,QAKZ;AAED;;GAEG;AACH,MAAM,MAAM;IAGU;IAFZ,MAAM,CAAC,KAAK,GAAa,QAAQ,CAAC,IAAI,CAAC;IAE/C,YAAoB,SAAiB;QAAjB,cAAS,GAAT,SAAS,CAAQ;IAAG,CAAC;IAEzC,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,MAAM,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnC,OAAO,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,SAAS,KAAK,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,MAAM,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,SAAS,KAAK,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,MAAM,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,SAAS,KAAK,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,MAAM,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnC,OAAO,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,SAAS,KAAK,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAA0C;QACxD,MAAM,QAAQ,GAAG;YACf,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC;QACF,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;;AAGH;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,WAAW,EAK7C,CAAC;IAEd,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/utils/serialization.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Truncate a string to a maximum length, adding an ellipsis if truncated
+ *
+ * @param value - The string to truncate
+ * @param maxLength - Maximum length
+ * @returns Truncated string
+ */
+export declare function truncateString(value: string, maxLength: number): string;
+/**
+ * Serialize a value for JSON output, handling non-serializable types and
+ * truncating long strings
+ *
+ * @param value - Value to serialize
+ * @param maxLength - Maximum length for strings (null for no truncation)
+ * @returns Serialized value
+ *
+ * @example
+ * ```typescript
+ * const serialized = serializeValue({ message: 'Hello'.repeat(1000) }, 100);
+ * // Result: { message: 'HelloHelloHello... [truncated]' }
+ * ```
+ */
+export declare function serializeValue(value: unknown, maxLength?: number | null): unknown;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/utils/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/utils/serialization.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKvE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,GAAE,MAAM,GAAG,IAAY,GAAG,OAAO,CAmCxF"}

package/dist/utils/serialization.js

@@ -0,0 +1,60 @@
+/**
+ * Truncate a string to a maximum length, adding an ellipsis if truncated
+ *
+ * @param value - The string to truncate
+ * @param maxLength - Maximum length
+ * @returns Truncated string
+ */
+export function truncateString(value, maxLength) {
+    if (value.length <= maxLength) {
+        return value;
+    }
+    return `${value.slice(0, maxLength)}... [truncated]`;
+}
+/**
+ * Serialize a value for JSON output, handling non-serializable types and
+ * truncating long strings
+ *
+ * @param value - Value to serialize
+ * @param maxLength - Maximum length for strings (null for no truncation)
+ * @returns Serialized value
+ *
+ * @example
+ * ```typescript
+ * const serialized = serializeValue({ message: 'Hello'.repeat(1000) }, 100);
+ * // Result: { message: 'HelloHelloHello... [truncated]' }
+ * ```
+ */
+export function serializeValue(value, maxLength = 10000) {
+    // Handle primitives that don't need serialization
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (typeof value === 'boolean' || typeof value === 'number') {
+        return value;
+    }
+    // Handle strings with truncation
+    if (typeof value === 'string') {
+        return maxLength !== null ? truncateString(value, maxLength) : value;
+    }
+    // Handle arrays
+    if (Array.isArray(value)) {
+        return value.map((item) => serializeValue(item, maxLength));
+    }
+    // Handle objects
+    if (typeof value === 'object') {
+        const result = {};
+        for (const [key, val] of Object.entries(value)) {
+            result[key] = serializeValue(val, maxLength);
+        }
+        return result;
+    }
+    // Handle other types by converting to string
+    try {
+        return String(value);
+    }
+    catch {
+        return `<${typeof value} object>`;
+    }
+}
+//# sourceMappingURL=serialization.js.map

package/dist/utils/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../src/utils/serialization.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,SAAiB;IAC7D,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,iBAAiB,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,YAA2B,KAAK;IAC7E,kDAAkD;IAClD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,iCAAiC;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACvE,CAAC;IAED,gBAAgB;IAChB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,iBAAiB;IACjB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6CAA6C;IAC7C,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,OAAO,KAAK,UAAU,CAAC;IACpC,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@prefactor/core",
+  "version": "0.1.0",
+  "description": "Framework-agnostic observability primitives for Prefactor",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "prefactor",
+    "observability",
+    "tracing",
+    "llm",
+    "agent",
+    "monitoring"
+  ],
+  "author": "Prefactor",
+  "license": "MIT",
+  "dependencies": {
+    "@prefactor/pfid": "^0.1.0",
+    "zod": "^3.23.0"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}