@soulcraft/brainy 0.28.0 → 0.30.0

package/dist/utils/environmentDetection.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Environment Detection Utilities
+ * Detects environment characteristics to determine if statistics synchronization is needed
+ */
+/**
+ * Environment detection result
+ */
+export interface EnvironmentInfo {
+    /** Whether the environment supports multi-instance scenarios */
+    supportsMultiInstance: boolean;
+    /** Whether statistics synchronization should be enabled by default */
+    needsStatisticsSynchronization: boolean;
+    /** The detected environment type */
+    environmentType: 'browser' | 'node' | 'worker' | 'unknown';
+    /** Whether the environment is likely to be used in production */
+    isProduction: boolean;
+    /** Additional environment details */
+    details: {
+        hasProcess: boolean;
+        hasWindow: boolean;
+        hasWorker: boolean;
+        nodeVersion?: string;
+        userAgent?: string;
+    };
+}
+/**
+ * Detect the current environment and determine if statistics synchronization is needed
+ * @returns Environment information including synchronization requirements
+ */
+export declare function detectEnvironment(): EnvironmentInfo;
+/**
+ * Check if statistics synchronization should be enabled for a given storage type
+ * @param storageType The type of storage being used
+ * @param environmentInfo Optional environment info (will be detected if not provided)
+ * @returns Whether statistics synchronization should be enabled
+ */
+export declare function shouldEnableStatisticsSynchronization(storageType: string, environmentInfo?: EnvironmentInfo): boolean;
+/**
+ * Get recommended storage configuration based on environment
+ * @param environmentInfo Optional environment info (will be detected if not provided)
+ * @returns Recommended storage configuration
+ */
+export declare function getRecommendedStorageConfig(environmentInfo?: EnvironmentInfo): {
+    type: string;
+    enableStatisticsSynchronization: boolean;
+    reason: string;
+};

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

@@ -0,0 +1 @@
+{"version":3,"file":"environmentDetection.d.ts","sourceRoot":"","sources":["../../src/utils/environmentDetection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,qBAAqB,EAAE,OAAO,CAAA;IAC9B,sEAAsE;IACtE,8BAA8B,EAAE,OAAO,CAAA;IACvC,oCAAoC;IACpC,eAAe,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAA;IAC1D,iEAAiE;IACjE,YAAY,EAAE,OAAO,CAAA;IACrB,qCAAqC;IACrC,OAAO,EAAE;QACP,UAAU,EAAE,OAAO,CAAA;QACnB,SAAS,EAAE,OAAO,CAAA;QAClB,SAAS,EAAE,OAAO,CAAA;QAClB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;CACF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,eAAe,CAkDnD;AAED;;;;;GAKG;AACH,wBAAgB,qCAAqC,CACnD,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,eAAe,GAChC,OAAO,CA2BT;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,eAAe,CAAC,EAAE,eAAe,GAAG;IAC9E,IAAI,EAAE,MAAM,CAAA;IACZ,+BAA+B,EAAE,OAAO,CAAA;IACxC,MAAM,EAAE,MAAM,CAAA;CACf,CAoCA"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Centralized logging utility for Brainy
+ *
+ * This utility provides controlled logging that can be enabled/disabled
+ * based on debug mode configuration. By default, all logging is disabled
+ * unless explicitly enabled via environment variables or configuration.
+ */
+/**
+ * Logger configuration interface
+ */
+export interface LoggerConfig {
+    /**
+     * Whether debug logging is enabled
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Whether to show log prefixes
+     * @default true
+     */
+    showPrefix?: boolean;
+    /**
+     * Custom prefix for log messages
+     * @default 'Brainy'
+     */
+    prefix?: string;
+}
+/**
+ * Configure the global logger
+ */
+export declare function configureLogger(config: LoggerConfig): void;
+/**
+ * Get current logger configuration
+ */
+export declare function getLoggerConfig(): Required<LoggerConfig>;
+/**
+ * Check if debug mode is enabled
+ */
+export declare function isDebugEnabled(): boolean;
+/**
+ * Controlled logging methods
+ */
+export declare const logger: {
+    /**
+     * Log debug information (only shown when debug mode is enabled)
+     */
+    debug: (message: string, ...args: any[]) => void;
+    /**
+     * Log informational messages (only shown when debug mode is enabled)
+     */
+    info: (message: string, ...args: any[]) => void;
+    /**
+     * Log warning messages (always shown, but can be controlled)
+     */
+    warn: (message: string, ...args: any[]) => void;
+    /**
+     * Log error messages (always shown)
+     */
+    error: (message: string, ...args: any[]) => void;
+    /**
+     * Log with custom prefix (only shown when debug mode is enabled)
+     */
+    debugWithPrefix: (prefix: string, message: string, ...args: any[]) => void;
+    /**
+     * Log info with custom prefix (only shown when debug mode is enabled)
+     */
+    infoWithPrefix: (prefix: string, message: string, ...args: any[]) => void;
+    /**
+     * Log warning with custom prefix (controlled by debug mode)
+     */
+    warnWithPrefix: (prefix: string, message: string, ...args: any[]) => void;
+    /**
+     * Log error with custom prefix (always shown)
+     */
+    errorWithPrefix: (prefix: string, message: string, ...args: any[]) => void;
+};
+/**
+ * Legacy console methods for backward compatibility
+ * These will respect the debug mode setting
+ */
+export declare const debugConsole: {
+    log: (message: string, ...args: any[]) => void;
+    debug: (message: string, ...args: any[]) => void;
+    info: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+    error: (message: string, ...args: any[]) => void;
+};
+/**
+ * Enable debug mode programmatically
+ */
+export declare function enableDebugMode(): void;
+/**
+ * Disable debug mode programmatically
+ */
+export declare function disableDebugMode(): void;
+/**
+ * Create a scoped logger with a specific prefix
+ */
+export declare function createScopedLogger(prefix: string): typeof logger;

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAqDD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAE1D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,QAAQ,CAAC,YAAY,CAAC,CAExD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAeD;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;qBACc,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;IAM9C;;OAEG;oBACa,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;IAM7C;;OAEG;oBACa,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;IAM7C;;OAEG;qBACc,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;IAI9C;;OAEG;8BACuB,MAAM,WAAW,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;IAMxE;;OAEG;6BACsB,MAAM,WAAW,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;IAMvE;;OAEG;6BACsB,MAAM,WAAW,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;IAMvE;;OAEG;8BACuB,MAAM,WAAW,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;CAGzE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;mBA7DP,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;qBAT5B,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;oBAS9B,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;oBAS7B,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;qBAS5B,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;CAiD/C,CAAA;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,MAAM,CAWhE"}

package/dist/utils/version.d.ts

@@ -0,0 +1,5 @@
+/**
+ * This file is auto-generated during the build process.
+ * Do not modify this file directly.
+ */
+export declare const VERSION = "0.12.0";

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "description": "A vector graph database using HNSW indexing with Origin Private File System storage",
   "main": "dist/unified.js",
   "module": "dist/unified.js",
@@ -54,19 +54,25 @@
     "build:browser": "BUILD_TYPE=browser rollup -c rollup.config.js",
     "start": "node dist/unified.js",
     "demo": "npm run build && npm run build:browser && npx http-server -o /demo/index.html",
-    "version": "echo 'Version updated in package.json'",
-    "version:patch": "npm version patch && node scripts/update-changelog.js",
-    "version:minor": "npm version minor && node scripts/update-changelog.js",
-    "version:major": "npm version major && node scripts/update-changelog.js",
-    "changelog:update": "node scripts/update-changelog.js",
-    "changelog:check": "echo 'Please ensure CHANGELOG.md [Unreleased] section has your changes before releasing'",
+    "release": "standard-version",
+    "release:patch": "standard-version --release-as patch",
+    "release:minor": "standard-version --release-as minor",
+    "release:major": "standard-version --release-as major",
+    "release:dry-run": "standard-version --dry-run",
+    "github-release": "node scripts/create-github-release.js",
+    "changelog:check": "echo 'Changelog is now automatically generated from commit messages'",
     "lint": "eslint --ext .ts,.js src/",
     "lint:fix": "eslint --ext .ts,.js src/ --fix",
     "format": "prettier --write \"src/**/*.{ts,js}\"",
     "check:format": "prettier --check \"src/**/*.{ts,js}\"",
     "check:style": "node scripts/check-code-style.js",
     "prepare": "npm run build",
-    "deploy": "npm run build && npm publish && node scripts/create-github-release.js",
+    "deploy": "npm run build && npm publish",
+    "workflow": "node scripts/release-workflow.js",
+    "workflow:patch": "node scripts/release-workflow.js patch",
+    "workflow:minor": "node scripts/release-workflow.js minor",
+    "workflow:major": "node scripts/release-workflow.js major",
+    "workflow:dry-run": "npm run build && npm test && npm run release:dry-run",
     "dry-run": "npm pack --dry-run",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -148,6 +154,7 @@
     "puppeteer": "^22.5.0",
     "rollup": "^4.13.0",
     "rollup-plugin-terser": "^7.0.2",
+    "standard-version": "^9.5.0",
     "tslib": "^2.6.2",
     "typescript": "^5.4.5",
     "vitest": "^3.2.4"