v7.0.9

.serena/.gitignore

@@ -1 +0,0 @@
-/cache

.serena/memories/code_style_conventions.md

@@ -1,44 +0,0 @@
-# Code Style & Conventions
-
-## TypeScript Standards
-- **Target**: ES2022
-- **Module System**: ESM with NodeNext resolution
-- **Decorators**: Experimental decorators enabled
-- **Strict Mode**: Implied through TypeScript configuration
-
-## Naming Conventions
-- **Interfaces**: Prefix with `I` (e.g., `IUserData`, `IConfig`)
-- **Types**: Prefix with `T` (e.g., `TResponseType`, `TQueryResult`)
-- **Classes**: PascalCase (e.g., `SmartdataDb`, `SmartDataDbDoc`)
-- **Files**: All lowercase (e.g., `classes.doc.ts`, `plugins.ts`)
-- **Methods**: camelCase (e.g., `findOne`, `saveToDb`)
-
-## Import Patterns
-- All external dependencies imported in `ts/plugins.ts`
-- Reference as `plugins.moduleName.method()`
-- Use full import paths for internal modules
-- Maintain ESM syntax throughout
-
-## Class Structure
-- Use decorators for MongoDB document definitions
-- Extend base classes (SmartDataDbDoc, SmartDataDbCollection)
-- Static methods for factory patterns
-- Instance methods for document operations
-
-## Async Patterns
-- Preserve Promise-based patterns
-- Use async/await for clarity
-- Handle errors appropriately
-- Return typed Promises
-
-## MongoDB Specifics
-- Use `@unify()` decorator for unique fields
-- Use `@svDb()` decorator for database fields
-- Implement proper serialization/deserialization
-- Type-safe query construction with DeepQuery<T>
-
-## Testing Patterns
-- Import from `@git.zone/tstest/tapbundle`
-- End test files with `export default tap.start()`
-- Use descriptive test names
-- Cover edge cases and error conditions

.serena/memories/project_overview.md

@@ -1,37 +0,0 @@
-# Project Overview: @push.rocks/smartdata
-
-## Purpose
-An advanced TypeScript-first MongoDB wrapper library providing enterprise-grade features for distributed systems, real-time data synchronization, and easy data management.
-
-## Tech Stack
-- **Language**: TypeScript (ES2022 target)
-- **Runtime**: Node.js >= 16.x
-- **Database**: MongoDB >= 4.4
-- **Build System**: tsbuild
-- **Test Framework**: tstest with tapbundle
-- **Package Manager**: pnpm (v10.7.0)
-- **Module System**: ESM (ES Modules)
-
-## Key Features
-- Type-safe MongoDB integration with decorators
-- Document management with automatic timestamps
-- EasyStore for key-value storage
-- Distributed coordination with leader election
-- Real-time data sync with RxJS watchers
-- Deep query type safety
-- Enhanced cursor API
-- Powerful search capabilities
-
-## Project Structure
-- **ts/**: Main TypeScript source code
-  - Core classes for DB, Collections, Documents, Cursors
-  - Distributed coordinator, EasyStore, Watchers
-  - Lucene adapter for search functionality
-- **test/**: Test files using tstest framework
-- **dist_ts/**: Compiled JavaScript output
-
-## Key Dependencies
-- MongoDB driver (v6.18.0)
-- @push.rocks ecosystem packages
-- @tsclass/tsclass for decorators
-- RxJS for reactive programming

.serena/memories/suggested_commands.md

@@ -1,35 +0,0 @@
-# Suggested Commands for @push.rocks/smartdata
-
-## Build & Development
-- `pnpm build` - Build the TypeScript project with web support
-- `pnpm buildDocs` - Generate documentation using tsdoc
-- `tsbuild --web --allowimplicitany` - Direct build command
-
-## Testing
-- `pnpm test` - Run all tests in test/ directory
-- `pnpm testSearch` - Run specific search test
-- `tstest test/test.specific.ts --verbose` - Run specific test with verbose output
-- `tsbuild check test/**/* --skiplibcheck` - Type check test files
-
-## Package Management
-- `pnpm install` - Install dependencies
-- `pnpm install --save-dev <package>` - Add dev dependency
-- `pnpm add <package>` - Add production dependency
-
-## Version Control
-- `git status` - Check current changes
-- `git diff` - View uncommitted changes
-- `git log --oneline -10` - View recent commits
-- `git mv <old> <new>` - Move/rename files preserving history
-
-## System Utilities (Linux)
-- `ls -la` - List all files with details
-- `grep -r "pattern" .` - Search for pattern in files
-- `find . -name "*.ts"` - Find TypeScript files
-- `ps aux | grep node` - Find Node.js processes
-- `lsof -i :80` - Check process on port 80
-
-## Debug & Development
-- `tsx <script.ts>` - Run TypeScript file directly
-- Store debug scripts in `.nogit/debug/`
-- Curl endpoints for API testing

.serena/memories/task_completion_checklist.md

@@ -1,33 +0,0 @@
-# Task Completion Checklist
-
-When completing any coding task in this project, always:
-
-## Before Committing
-1. **Build the project**: Run `pnpm build` to ensure TypeScript compiles
-2. **Run tests**: Execute `pnpm test` to verify nothing is broken
-3. **Type check**: Verify types compile correctly
-4. **Check for lint issues**: Look for any code style violations
-
-## Code Quality Checks
-- Verify all imports are in `ts/plugins.ts` for external dependencies
-- Check that interfaces are prefixed with `I`
-- Check that types are prefixed with `T`
-- Ensure filenames are lowercase
-- Verify async patterns are preserved where needed
-- Check that decorators are properly used for MongoDB documents
-
-## Documentation
-- Update relevant comments if functionality changed
-- Ensure new exports are properly documented
-- Update readme.md if new features added (only if explicitly requested)
-
-## Git Hygiene
-- Make small, focused commits
-- Write clear commit messages
-- Use `git mv` for file operations
-- Never commit sensitive data or keys
-
-## Final Verification
-- Test the specific functionality that was changed
-- Ensure no unintended side effects
-- Verify the change solves the original problem completely

.serena/project.yml

@@ -1,68 +0,0 @@
-# language of the project (csharp, python, rust, java, typescript, go, cpp, or ruby)
-#  * For C, use cpp
-#  * For JavaScript, use typescript
-# Special requirements:
-#  * csharp: Requires the presence of a .sln file in the project folder.
-language: typescript
-
-# whether to use the project's gitignore file to ignore files
-# Added on 2025-04-07
-ignore_all_files_in_gitignore: true
-# list of additional paths to ignore
-# same syntax as gitignore, so you can use * and **
-# Was previously called `ignored_dirs`, please update your config if you are using that.
-# Added (renamed)on 2025-04-07
-ignored_paths: []
-
-# whether the project is in read-only mode
-# If set to true, all editing tools will be disabled and attempts to use them will result in an error
-# Added on 2025-04-18
-read_only: false
-
-
-# list of tool names to exclude. We recommend not excluding any tools, see the readme for more details.
-# Below is the complete list of tools for convenience.
-# To make sure you have the latest list of tools, and to view their descriptions, 
-# execute `uv run scripts/print_tool_overview.py`.
-#
-#  * `activate_project`: Activates a project by name.
-#  * `check_onboarding_performed`: Checks whether project onboarding was already performed.
-#  * `create_text_file`: Creates/overwrites a file in the project directory.
-#  * `delete_lines`: Deletes a range of lines within a file.
-#  * `delete_memory`: Deletes a memory from Serena's project-specific memory store.
-#  * `execute_shell_command`: Executes a shell command.
-#  * `find_referencing_code_snippets`: Finds code snippets in which the symbol at the given location is referenced.
-#  * `find_referencing_symbols`: Finds symbols that reference the symbol at the given location (optionally filtered by type).
-#  * `find_symbol`: Performs a global (or local) search for symbols with/containing a given name/substring (optionally filtered by type).
-#  * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes.
-#  * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file.
-#  * `initial_instructions`: Gets the initial instructions for the current project.
-#     Should only be used in settings where the system prompt cannot be set,
-#     e.g. in clients you have no control over, like Claude Desktop.
-#  * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol.
-#  * `insert_at_line`: Inserts content at a given line in a file.
-#  * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol.
-#  * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
-#  * `list_memories`: Lists memories in Serena's project-specific memory store.
-#  * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
-#  * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with the necessary context).
-#  * `read_file`: Reads a file within the project directory.
-#  * `read_memory`: Reads the memory with the given name from Serena's project-specific memory store.
-#  * `remove_project`: Removes a project from the Serena configuration.
-#  * `replace_lines`: Replaces a range of lines within a file with new content.
-#  * `replace_symbol_body`: Replaces the full definition of a symbol.
-#  * `restart_language_server`: Restarts the language server, may be necessary when edits not through Serena happen.
-#  * `search_for_pattern`: Performs a search for a pattern in the project.
-#  * `summarize_changes`: Provides instructions for summarizing the changes made to the codebase.
-#  * `switch_modes`: Activates modes by providing a list of their names
-#  * `think_about_collected_information`: Thinking tool for pondering the completeness of collected information.
-#  * `think_about_task_adherence`: Thinking tool for determining whether the agent is still on track with the current task.
-#  * `think_about_whether_you_are_done`: Thinking tool for determining whether the task is truly completed.
-#  * `write_memory`: Writes a named memory (for future reference) to Serena's project-specific memory store.
-excluded_tools: []
-
-# initial prompt for the project. It will always be given to the LLM upon activating the project
-# (contrary to the memories, which are loaded on demand).
-initial_prompt: ""
-
-project_name: "smartdata"

changelog.md

@@ -1,5 +1,88 @@
 # Changelog
 
+## 2025-11-28 - 7.0.9 - fix(classes.collection)
+Fix closure bug in Collection decorator by defining collection getter on original constructor and prototype
+
+- Define the collection getter on the original constructor so class-level references (e.g. `User.collection`) resolve to the decorated collection instead of the original constructor's closure value.
+- Also define the getter on the original constructor's prototype to ensure instance access works consistently across runtimes (Deno/Node).
+
+## 2025-11-28 - 7.0.8 - fix(classes.collection)
+Fix closure issue in managed decorator so Class.collection/instance.collection resolve correctly
+
+- Resolve closure bug in the managed() decorator where class methods referencing Class.collection (or instance.collection) could receive the original constructor's captured value and thus the wrong collection/manager.
+- Define dynamic getters on the original constructor and its prototype that compute the collection from the proper manager/db at access time (supports direct manager objects, delayed manager factory functions, and fallback to defaultManager).
+- Getters are defined as non-enumerable and configurable to preserve compatibility with existing consumers.
+
+## 2025-11-28 - 7.0.7 - fix(decorators)
+Fix decorator metadata initialization and Lucene query transformation
+
+- Ensure TC39 decorator metadata is used to initialize prototype properties so decorators work reliably across runtimes (context.metadata / Symbol.metadata shim imported early).
+- Field and class decorators now populate and consume metadata for saveable properties, indexes and searchable fields so prototype initialization happens before instance creation.
+- Fix Lucene -> MongoDB transformer to produce correct $or/$and/$not structures and improve wildcard/fuzzy/range handling for search queries.
+- Improve collection initialization to auto-create compound text indexes from searchableFields and ensure index creation is idempotent.
+
+## 2025-11-28 - 7.0.6 - fix(classes.collection)
+Guard against missing collection before attaching document constructor in Collection decorator
+
+- Added a truthy check for `coll` before setting `(coll as any).docCtor` in the Collection decorator (ts/classes.collection.ts).
+- Prevents a potential TypeError when `collectionFactory.getCollection` returns null/undefined during decorator initialization.
+
+## 2025-11-28 - 7.0.5 - fix(package)
+Add package exports entry and remove legacy main/typings fields
+
+- Added an "exports" entry in package.json mapping "." to ./dist_ts/index.js to declare the package's ESM entrypoint.
+- Removed legacy "main" and "typings" fields from package.json.
+- Improves Node/module resolution and modern bundler compatibility by using the package exports field.
+
+## 2025-11-28 - 7.0.4 - fix(decorators)
+Add Symbol.metadata polyfill and import it at entry to ensure decorator metadata is available
+
+- Add ts/shim.ts: defines Symbol.metadata when missing (polyfill for TC39 Stage 3 decorator metadata).
+- Import './shim.js' at the very top of ts/index.ts so the polyfill runs before any decorator code or exports are evaluated.
+- Prevents runtime errors when decorators rely on Symbol.metadata and improves compatibility across runtimes/environments.
+
+## 2025-11-28 - 7.0.3 - fix(build)
+Bump devDependency @git.zone/tsbuild to ^3.1.2
+
+- Updated @git.zone/tsbuild in devDependencies from ^3.1.1 to ^3.1.2
+
+## 2025-11-28 - 7.0.2 - fix(collectionfactory)
+Simplify CollectionFactory.getCollection: remove unnecessary IIFE and instantiate collection only when dbArg is SmartdataDb
+
+- Remove redundant IIFE wrapper in getCollection for improved readability
+- Only create and cache a SmartdataCollection when dbArg is an instance of SmartdataDb
+- Avoid assigning undefined to the collections map by guarding instantiation and returning existing collection
+
+## 2025-11-27 - 7.0.1 - fix(build)
+Update build tooling and TypeScript compilation target
+
+- Bump devDependency @git.zone/tsbuild from ^3.1.0 to ^3.1.1.
+- Update tsconfig.json compiler target from ES2022 to ES2024 (affects emitted JS language level).
+
+## 2025-11-27 - 7.0.0 - BREAKING CHANGE(mongodb)
+Upgrade dependencies: bump mongodb to ^7.0.0 and @git.zone/tstest to ^3.1.3
+
+- Bump 'mongodb' dependency from ^6.20.0 to ^7.0.0 — major version upgrade; may introduce breaking API changes and require code updates or verification against the new driver.
+- Update devDependency '@git.zone/tstest' from ^2.8.1 to ^3.1.3 — test tooling updated.
+
+## 2025-11-17 - 6.0.0 - BREAKING CHANGE(decorators)
+Migrate to TC39 Stage 3 decorators and refactor decorator metadata handling; update class initialization, lucene adapter fixes and docs
+
+- Switch all decorators to TC39 Stage 3 signatures and metadata usage (use context.metadata and context.addInitializer) — affects svDb, globalSvDb, searchable, unI, index, Collection and managed.
+- Refactor Collection/managed decorators to read and initialize prototype/constructor properties from context.metadata to ensure prototype properties are available before instance creation (ts/classes.collection.ts).
+- Improve search implementation: add a Lucene parser and transformer with safer MongoDB query generation, wildcard/fuzzy handling and properly structured boolean operators (ts/classes.lucene.adapter.ts).
+- Search integration updated to use the new adapter and handle advanced Lucene syntax and edge cases more robustly.
+- Bump dev tooling versions: @git.zone/tsbuild -> ^3.1.0 and @git.zone/tsrun -> ^2.0.0.
+- Documentation: update README and add readme.hints.md describing the TC39 decorator migration, minimum TypeScript (>=5.2) and Deno notes; tests adjusted accordingly.
+- Clean up project memory/config files related to the previous decorator approach and Deno configuration adjustments.
+
+## 2025-11-17 - 5.16.7 - fix(classes.collection)
+Improve Deno and TypeScript compatibility: Collection decorator _svDbOptions forwarding and config cleanup
+
+- Collection decorator: capture original constructor and forward _svDbOptions to ensure property decorator options (serialize/deserialize) remain accessible in Deno environments.
+- Collection decorator: keep instance getter defined on prototype for Deno compatibility (no behavior change, clarifies forwarding logic).
+- Build/config: removed experimentalDecorators and useDefineForClassFields from deno.json and tsconfig.json to avoid Deno/TS build issues and rely on default compilation settings.
+
 ## 2025-11-17 - 5.16.6 - fix(classes)
 Add Deno compatibility, prototype-safe decorators and safe collection accessor; bump a few deps
 

deno.json

@@ -1,11 +0,0 @@
-{
-  "compilerOptions": {
-    "experimentalDecorators": true,
-    "lib": [
-      "ES2022",
-      "DOM"
-    ]
-  },
-  "nodeModulesDir": "auto",
-  "version": "5.16.6"
-}

package.json

@@ -1,10 +1,11 @@
 {
   "name": "@push.rocks/smartdata",
-  "version": "5.16.6",
+  "version": "7.0.9",
   "private": false,
   "description": "An advanced library for NoSQL data organization and manipulation using TypeScript with support for MongoDB, data validation, collections, and custom data types.",
-  "main": "dist_ts/index.js",
-  "typings": "dist_ts/index.d.ts",
+  "exports": {
+    ".": "./dist_ts/index.js"
+  },
   "type": "module",
   "scripts": {
     "test": "tstest test/ --verbose --logfile --timeout 120",
@@ -34,12 +35,12 @@
     "@push.rocks/smartunique": "^3.0.8",
     "@push.rocks/taskbuffer": "^3.4.0",
     "@tsclass/tsclass": "^9.3.0",
-    "mongodb": "^6.20.0"
+    "mongodb": "^7.0.0"
   },
   "devDependencies": {
-    "@git.zone/tsbuild": "^2.7.1",
-    "@git.zone/tsrun": "^1.6.2",
-    "@git.zone/tstest": "^2.8.1",
+    "@git.zone/tsbuild": "^3.1.2",
+    "@git.zone/tsrun": "^2.0.0",
+    "@git.zone/tstest": "^3.1.3",
     "@push.rocks/qenv": "^6.1.3",
     "@push.rocks/tapbundle": "^6.0.3",
     "@types/node": "^22.15.2"

readme.hints.md

@@ -0,0 +1,80 @@
+# Project Memory - Smartdata
+
+## TC39 Decorator Migration (v6.0.0) - ✅ COMPLETED
+
+### Final Status: All Tests Passing (157/157)
+Migration successfully completed on 2025-11-17.
+
+### What Changed:
+- ✅ Removed `experimentalDecorators` from tsconfig.json
+- ✅ Refactored all 7 decorators to TC39 Stage 3 syntax
+  - 5 property decorators: @globalSvDb, @svDb, @unI, @index, @searchable
+  - 2 class decorators: @Collection, @managed
+- ✅ Implemented context.metadata pattern for shared decorator state
+- ✅ All tests passing across Node.js and Deno runtimes
+
+### Critical Discovery: TC39 Metadata Access Pattern
+**THE KEY INSIGHT**: In TC39 decorators, metadata is NOT accessed via `constructor[Symbol.metadata]`. Instead:
+- **Field decorators**: Write to `context.metadata`
+- **Class decorators**: Read from `context.metadata` (same shared object!)
+- The `context.metadata` object is shared between all decorators on the same class
+- Attempting to write to `constructor[Symbol.metadata]` throws: "Cannot assign to read only property"
+
+### Implementation Pattern:
+```typescript
+// Field decorator - stores metadata
+export function svDb() {
+  return (value: undefined, context: ClassFieldDecoratorContext) => {
+    const metadata = context.metadata as ISmartdataDecoratorMetadata;
+    if (!metadata.saveableProperties) {
+      metadata.saveableProperties = [];
+    }
+    metadata.saveableProperties.push(String(context.name));
+  };
+}
+
+// Class decorator - reads metadata and initializes prototype
+export function Collection(dbArg: SmartdataDb) {
+  return function(value: Function, context: ClassDecoratorContext) => {
+    const metadata = context.metadata as ISmartdataDecoratorMetadata;
+    if (metadata?.saveableProperties) {
+      decoratedClass.prototype.saveableProperties = [...metadata.saveableProperties];
+    }
+    return decoratedClass;
+  };
+}
+```
+
+### Runtime Compatibility:
+- ✅ **Node.js v23.8.0**: Full TC39 support
+- ✅ **Deno v2.5.4**: Full TC39 support
+- ❌ **Bun v1.3.0**: No TC39 support (uses legacy decorators only)
+  - Removed "+bun" from test filenames to skip Bun tests
+
+### Key Technical Notes:
+1. **Metadata Initialization Timing**: Class decorators run AFTER field decorators, allowing them to read accumulated metadata and initialize prototypes before any instances are created
+2. **Prototype vs Instance Properties**: Properties set on prototype are accessible via `this.propertyName` in instances
+3. **TypeScript Lib Support**: TypeScript 5.9.3 includes built-in decorator types (no custom lib configuration needed)
+4. **Interface Naming**: Used `ISmartdataDecoratorMetadata` extending `DecoratorMetadataObject` for type safety
+
+### Files Modified:
+- ts/classes.doc.ts (property decorators + metadata interface)
+- ts/classes.collection.ts (class decorators + prototype initialization)
+- tsconfig.json (removed experimentalDecorators flag)
+- test/*.ts (renamed files to remove "+bun" suffix)
+
+### Test Results:
+All 157 tests passing across 10 test files:
+- test.cursor.ts: 7/7
+- test.deno.ts: 11/11 (queries working correctly!)
+- test.search.advanced.ts: 41/41
+- test.typescript.ts: 4/4
+- test.watch.ts: 5/5
+- And 5 more test files
+
+### Migration Learnings for Future Reference:
+1. `context.metadata` is the ONLY way to share state between decorators
+2. Class decorators must initialize prototypes from metadata immediately
+3. `Symbol.metadata` on constructors is read-only (managed by runtime)
+4. Field decorators run before class decorators (guaranteed order)
+5. TypeScript 5.2+ has built-in TC39 decorator support

readme.md

@@ -8,7 +8,7 @@
 
 SmartData isn't just another MongoDB wrapper - it's a complete paradigm shift in how you work with databases:
 
-- 🔒 **100% Type-Safe**: Full TypeScript with decorators, generics, and compile-time query validation
+- 🔒 **100% Type-Safe**: Full TypeScript with TC39 Stage 3 decorators, generics, and compile-time query validation
 - ⚡ **Lightning Fast**: Connection pooling, cursor streaming, and intelligent indexing
 - 🔄 **Real-time Ready**: MongoDB Change Streams with RxJS for reactive applications
 - 🌍 **Distributed Systems**: Built-in leader election and task coordination
@@ -31,8 +31,11 @@ yarn add @push.rocks/smartdata
 ## 🚦 Requirements
 
 - **Node.js** >= 16.x
+- **Deno** >= 1.40 (for Deno projects)
 - **MongoDB** >= 4.4
-- **TypeScript** >= 4.x (for development)
+- **TypeScript** >= 5.2 (for TC39 decorator support)
+
+> **Note**: SmartData v6.0+ uses TC39 Stage 3 decorators (the new standard). If you're migrating from v5.x, you'll need to remove `experimentalDecorators` from your tsconfig.json. Bun is not currently supported as it doesn't implement TC39 decorators yet.
 
 ## 🎯 Quick Start
 

ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@push.rocks/smartdata',
-  version: '5.16.6',
+  version: '7.0.9',
   description: 'An advanced library for NoSQL data organization and manipulation using TypeScript with support for MongoDB, data validation, collections, and custom data types.'
 }

ts/classes.collection.ts

@@ -26,10 +26,14 @@ const collectionFactory = new CollectionFactory();
  * @param dbArg
  */
 export function Collection(dbArg: SmartdataDb | TDelayed<SmartdataDb>) {
-  return function classDecorator<T extends { new (...args: any[]): {} }>(constructor: T) {
-    // Capture original constructor's prototype in closure for Deno compatibility
-    const originalPrototype = constructor.prototype;
-    const originalConstructor = constructor as any;
+  return function classDecorator(value: Function, context: ClassDecoratorContext) {
+    if (context.kind !== 'class') {
+      throw new Error('Collection can only decorate classes');
+    }
+
+    // Capture original constructor for _svDbOptions forwarding
+    const originalConstructor = value as any;
+    const constructor = value as { new (...args: any[]): any };
 
     const getCollection = () => {
       if (!(dbArg instanceof SmartdataDb)) {
@@ -37,7 +41,7 @@ export function Collection(dbArg: SmartdataDb | TDelayed<SmartdataDb>) {
       }
       const coll = collectionFactory.getCollection(constructor.name, dbArg);
       // Attach document constructor for searchableFields lookup
-      if (!(coll as any).docCtor) {
+      if (coll && !(coll as any).docCtor) {
         (coll as any).docCtor = decoratedClass;
       }
       return coll;
@@ -60,6 +64,20 @@ export function Collection(dbArg: SmartdataDb | TDelayed<SmartdataDb>) {
       configurable: true
     });
 
+    // Closure fix: When class methods reference the class name (e.g., `User.collection`),
+    // they get the original constructor via closure, not the decorated class.
+    // Define collection getter on the original constructor.
+    Object.defineProperty(constructor, 'collection', {
+      get: getCollection,
+      enumerable: false,
+      configurable: true
+    });
+    Object.defineProperty(constructor.prototype, 'collection', {
+      get: getCollection,
+      enumerable: false,
+      configurable: true
+    });
+
     // Deno compatibility note: Property decorators set properties on the prototype.
     // Since we removed instance property declarations from SmartDataDbDoc,
     // the decorator-set prototype properties are now accessible without shadowing.
@@ -72,7 +90,44 @@ export function Collection(dbArg: SmartdataDb | TDelayed<SmartdataDb>) {
       configurable: true
     });
 
-    return decoratedClass;
+    // Initialize prototype properties from context.metadata (TC39 decorator metadata)
+    // This ensures prototype properties are available before any instance is created
+    const metadata = context.metadata as any;
+    if (metadata) {
+      const proto = decoratedClass.prototype;
+
+      // Initialize globalSaveableProperties
+      if (metadata.globalSaveableProperties && !proto.globalSaveableProperties) {
+        proto.globalSaveableProperties = [...metadata.globalSaveableProperties];
+      }
+
+      // Initialize saveableProperties
+      if (metadata.saveableProperties && !proto.saveableProperties) {
+        proto.saveableProperties = [...metadata.saveableProperties];
+      }
+
+      // Initialize uniqueIndexes
+      if (metadata.uniqueIndexes && !proto.uniqueIndexes) {
+        proto.uniqueIndexes = [...metadata.uniqueIndexes];
+      }
+
+      // Initialize regularIndexes
+      if (metadata.regularIndexes && !proto.regularIndexes) {
+        proto.regularIndexes = [...metadata.regularIndexes];
+      }
+
+      // Initialize searchableFields on constructor (not prototype)
+      if (metadata.searchableFields && !Array.isArray((decoratedClass as any).searchableFields)) {
+        (decoratedClass as any).searchableFields = [...metadata.searchableFields];
+      }
+
+      // Initialize _svDbOptions from metadata
+      if (metadata._svDbOptions && !originalConstructor._svDbOptions) {
+        originalConstructor._svDbOptions = { ...metadata._svDbOptions };
+      }
+    }
+
+    return decoratedClass as any;
   };
 }
 
@@ -90,7 +145,13 @@ export const setDefaultManagerForDoc = <T,>(managerArg: IManager, dbDocArg: T):
  * @param dbArg
  */
 export function managed<TManager extends IManager>(managerArg?: TManager | TDelayed<TManager>) {
-  return function classDecorator<T extends { new (...args: any[]): any }>(constructor: T) {
+  return function classDecorator(value: Function, context: ClassDecoratorContext) {
+    if (context.kind !== 'class') {
+      throw new Error('managed can only decorate classes');
+    }
+
+    const constructor = value as { new (...args: any[]): any };
+
     const decoratedClass = class extends constructor {
       public static className = constructor.name;
       public static get collection() {
@@ -140,7 +201,82 @@ export function managed<TManager extends IManager>(managerArg?: TManager | TDela
         return manager;
       }
     };
-    return decoratedClass;
+
+    // Closure fix: When class methods reference the class name (e.g., `User.collection`),
+    // they get the original constructor via closure, not the decorated class.
+    // Define collection/manager getters on the original constructor.
+    const getCollectionStatic = function(this: any) {
+      let dbArg: SmartdataDb;
+      if (!managerArg) {
+        dbArg = this.prototype.defaultManager.db;
+      } else if (managerArg['db']) {
+        dbArg = (managerArg as TManager).db;
+      } else {
+        dbArg = (managerArg as TDelayed<TManager>)().db;
+      }
+      return collectionFactory.getCollection(constructor.name, dbArg);
+    };
+    const getCollectionInstance = function(this: any) {
+      let dbArg: SmartdataDb;
+      if (!managerArg) {
+        dbArg = this.defaultManager.db;
+      } else if (managerArg['db']) {
+        dbArg = (managerArg as TManager).db;
+      } else {
+        dbArg = (managerArg as TDelayed<TManager>)().db;
+      }
+      return collectionFactory.getCollection(constructor.name, dbArg);
+    };
+    Object.defineProperty(constructor, 'collection', {
+      get: getCollectionStatic,
+      enumerable: false,
+      configurable: true
+    });
+    Object.defineProperty(constructor.prototype, 'collection', {
+      get: getCollectionInstance,
+      enumerable: false,
+      configurable: true
+    });
+
+    // Initialize prototype properties from context.metadata (TC39 decorator metadata)
+    // This ensures prototype properties are available before any instance is created
+    const originalConstructor = value as any;
+    const metadata = context.metadata as any;
+    if (metadata) {
+      const proto = decoratedClass.prototype;
+
+      // Initialize globalSaveableProperties
+      if (metadata.globalSaveableProperties && !proto.globalSaveableProperties) {
+        proto.globalSaveableProperties = [...metadata.globalSaveableProperties];
+      }
+
+      // Initialize saveableProperties
+      if (metadata.saveableProperties && !proto.saveableProperties) {
+        proto.saveableProperties = [...metadata.saveableProperties];
+      }
+
+      // Initialize uniqueIndexes
+      if (metadata.uniqueIndexes && !proto.uniqueIndexes) {
+        proto.uniqueIndexes = [...metadata.uniqueIndexes];
+      }
+
+      // Initialize regularIndexes
+      if (metadata.regularIndexes && !proto.regularIndexes) {
+        proto.regularIndexes = [...metadata.regularIndexes];
+      }
+
+      // Initialize searchableFields on constructor (not prototype)
+      if (metadata.searchableFields && !Array.isArray((decoratedClass as any).searchableFields)) {
+        (decoratedClass as any).searchableFields = [...metadata.searchableFields];
+      }
+
+      // Initialize _svDbOptions from metadata
+      if (metadata._svDbOptions && !originalConstructor._svDbOptions) {
+        originalConstructor._svDbOptions = { ...metadata._svDbOptions };
+      }
+    }
+
+    return decoratedClass as any;
   };
 }
 

ts/classes.collectionfactory.ts

@@ -6,13 +6,8 @@ export class CollectionFactory {
   public collections: { [key: string]: SmartdataCollection<any> } = {};
 
   public getCollection = (nameArg: string, dbArg: SmartdataDb): SmartdataCollection<any> => {
-    if (!this.collections[nameArg]) {
-      this.collections[nameArg] = (() => {
-        if (dbArg instanceof SmartdataDb) {
-          // tslint:disable-next-line: no-string-literal
-          return new SmartdataCollection(nameArg, dbArg);
-        }
-      })();
+    if (!this.collections[nameArg] && dbArg instanceof SmartdataDb) {
+      this.collections[nameArg] = new SmartdataCollection(nameArg, dbArg);
     }
     return this.collections[nameArg];
   };

ts/classes.doc.ts

@@ -28,15 +28,42 @@ export interface SearchOptions<T> {
 
 export type TDocCreation = 'db' | 'new' | 'mixed';
 
-
+// Type for decorator metadata - extends TypeScript's built-in DecoratorMetadataObject
+interface ISmartdataDecoratorMetadata extends DecoratorMetadataObject {
+  globalSaveableProperties?: string[];
+  saveableProperties?: string[];
+  uniqueIndexes?: string[];
+  regularIndexes?: Array<{field: string, options: IIndexOptions}>;
+  searchableFields?: string[];
+  _svDbOptions?: Record<string, SvDbOptions>;
+}
 
 export function globalSvDb() {
-  return (target: SmartDataDbDoc<unknown, unknown>, key: string) => {
-    logger.log('debug', `called svDb() on >${target.constructor.name}.${key}<`);
-    if (!target.globalSaveableProperties) {
-      target.globalSaveableProperties = [];
+  return (value: undefined, context: ClassFieldDecoratorContext) => {
+    if (context.kind !== 'field') {
+      throw new Error('globalSvDb can only decorate fields');
     }
-    target.globalSaveableProperties.push(key);
+
+    // Store metadata at class level using Symbol.metadata
+    const metadata = context.metadata as ISmartdataDecoratorMetadata;
+    if (!metadata.globalSaveableProperties) {
+      metadata.globalSaveableProperties = [];
+    }
+    metadata.globalSaveableProperties.push(String(context.name));
+
+    logger.log('debug', `called globalSvDb() on metadata for property ${String(context.name)}`);
+
+    // Use addInitializer to ensure prototype arrays are set up once
+    context.addInitializer(function(this: any) {
+      const proto = this.constructor.prototype;
+      const metadata = this.constructor[Symbol.metadata];
+
+      if (metadata && metadata.globalSaveableProperties && !proto.globalSaveableProperties) {
+        // Initialize prototype array from metadata (runs once per class)
+        proto.globalSaveableProperties = [...metadata.globalSaveableProperties];
+        logger.log('debug', `initialized globalSaveableProperties with ${proto.globalSaveableProperties.length} properties`);
+      }
+    });
   };
 }
 
@@ -54,20 +81,47 @@ export interface SvDbOptions {
  * saveable - saveable decorator to be used on class properties
  */
 export function svDb(options?: SvDbOptions) {
-  return (target: SmartDataDbDoc<unknown, unknown>, key: string) => {
-    logger.log('debug', `called svDb() on >${target.constructor.name}.${key}<`);
-    if (!target.saveableProperties) {
-      target.saveableProperties = [];
+  return (value: undefined, context: ClassFieldDecoratorContext) => {
+    if (context.kind !== 'field') {
+      throw new Error('svDb can only decorate fields');
     }
-    target.saveableProperties.push(key);
-    // attach custom serializer/deserializer options to the class constructor
-    const ctor = target.constructor as any;
-    if (!ctor._svDbOptions) {
-      ctor._svDbOptions = {};
+
+    const propName = String(context.name);
+
+    // Store metadata at class level using Symbol.metadata
+    const metadata = context.metadata as ISmartdataDecoratorMetadata;
+    if (!metadata.saveableProperties) {
+      metadata.saveableProperties = [];
     }
+    metadata.saveableProperties.push(propName);
+
+    // Store options in metadata
     if (options) {
-      ctor._svDbOptions[key] = options;
+      if (!metadata._svDbOptions) {
+        metadata._svDbOptions = {};
+      }
+      metadata._svDbOptions[propName] = options;
     }
+
+    logger.log('debug', `called svDb() on metadata for property ${propName}`);
+
+    // Use addInitializer to ensure prototype arrays are set up once
+    context.addInitializer(function(this: any) {
+      const proto = this.constructor.prototype;
+      const ctor = this.constructor;
+      const metadata = ctor[Symbol.metadata];
+
+      if (metadata && metadata.saveableProperties && !proto.saveableProperties) {
+        // Initialize prototype array from metadata (runs once per class)
+        proto.saveableProperties = [...metadata.saveableProperties];
+        logger.log('debug', `initialized saveableProperties with ${proto.saveableProperties.length} properties`);
+      }
+
+      // Initialize svDbOptions from metadata
+      if (metadata && metadata._svDbOptions && !ctor._svDbOptions) {
+        ctor._svDbOptions = { ...metadata._svDbOptions };
+      }
+    });
   };
 }
 
@@ -75,13 +129,30 @@ export function svDb(options?: SvDbOptions) {
  * searchable - marks a property as searchable with Lucene query syntax
  */
 export function searchable() {
-  return (target: SmartDataDbDoc<unknown, unknown>, key: string) => {
-    // Attach to class constructor for direct access
-    const ctor = target.constructor as any;
-    if (!Array.isArray(ctor.searchableFields)) {
-      ctor.searchableFields = [];
+  return (value: undefined, context: ClassFieldDecoratorContext) => {
+    if (context.kind !== 'field') {
+      throw new Error('searchable can only decorate fields');
     }
-    ctor.searchableFields.push(key);
+
+    const propName = String(context.name);
+
+    // Store metadata at class level
+    const metadata = context.metadata as ISmartdataDecoratorMetadata;
+    if (!metadata.searchableFields) {
+      metadata.searchableFields = [];
+    }
+    metadata.searchableFields.push(propName);
+
+    // Use addInitializer to set up constructor property once
+    context.addInitializer(function(this: any) {
+      const ctor = this.constructor as any;
+      const metadata = ctor[Symbol.metadata];
+
+      if (metadata && metadata.searchableFields && !Array.isArray(ctor.searchableFields)) {
+        // Initialize from metadata (runs once per class)
+        ctor.searchableFields = [...metadata.searchableFields];
+      }
+    });
   };
 }
 
@@ -94,20 +165,44 @@ function escapeForRegex(input: string): string {
  * unique index - decorator to mark a unique index
  */
 export function unI() {
-  return (target: SmartDataDbDoc<unknown, unknown>, key: string) => {
-    logger.log('debug', `called unI on >>${target.constructor.name}.${key}<<`);
-
-    // mark the index as unique
-    if (!target.uniqueIndexes) {
-      target.uniqueIndexes = [];
+  return (value: undefined, context: ClassFieldDecoratorContext) => {
+    if (context.kind !== 'field') {
+      throw new Error('unI can only decorate fields');
     }
-    target.uniqueIndexes.push(key);
 
-    // and also save it
-    if (!target.saveableProperties) {
-      target.saveableProperties = [];
+    const propName = String(context.name);
+
+    // Store metadata at class level
+    const metadata = context.metadata as ISmartdataDecoratorMetadata;
+    if (!metadata.uniqueIndexes) {
+      metadata.uniqueIndexes = [];
     }
-    target.saveableProperties.push(key);
+    metadata.uniqueIndexes.push(propName);
+
+    // Also mark as saveable
+    if (!metadata.saveableProperties) {
+      metadata.saveableProperties = [];
+    }
+    if (!metadata.saveableProperties.includes(propName)) {
+      metadata.saveableProperties.push(propName);
+    }
+
+    logger.log('debug', `called unI on metadata for property ${propName}`);
+
+    // Use addInitializer to ensure prototype arrays are set up once
+    context.addInitializer(function(this: any) {
+      const proto = this.constructor.prototype;
+      const metadata = this.constructor[Symbol.metadata];
+
+      if (metadata && metadata.uniqueIndexes && !proto.uniqueIndexes) {
+        proto.uniqueIndexes = [...metadata.uniqueIndexes];
+        logger.log('debug', `initialized uniqueIndexes with ${proto.uniqueIndexes.length} properties`);
+      }
+
+      if (metadata && metadata.saveableProperties && !proto.saveableProperties) {
+        proto.saveableProperties = [...metadata.saveableProperties];
+      }
+    });
   };
 }
 
@@ -126,28 +221,47 @@ export interface IIndexOptions {
  * index - decorator to mark a field for regular indexing
  */
 export function index(options?: IIndexOptions) {
-  return (target: SmartDataDbDoc<unknown, unknown>, key: string) => {
-    logger.log('debug', `called index() on >${target.constructor.name}.${key}<`);
-    
-    // Initialize regular indexes array if it doesn't exist
-    if (!target.regularIndexes) {
-      target.regularIndexes = [];
+  return (value: undefined, context: ClassFieldDecoratorContext) => {
+    if (context.kind !== 'field') {
+      throw new Error('index can only decorate fields');
     }
 
-    // Add this field to regularIndexes with its options
-    target.regularIndexes.push({
-      field: key,
+    const propName = String(context.name);
+
+    // Store metadata at class level
+    const metadata = context.metadata as ISmartdataDecoratorMetadata;
+    if (!metadata.regularIndexes) {
+      metadata.regularIndexes = [];
+    }
+    metadata.regularIndexes.push({
+      field: propName,
       options: options || {}
     });
 
-    // Also ensure it's marked as saveable
-    if (!target.saveableProperties) {
-      target.saveableProperties = [];
+    // Also mark as saveable
+    if (!metadata.saveableProperties) {
+      metadata.saveableProperties = [];
+    }
+    if (!metadata.saveableProperties.includes(propName)) {
+      metadata.saveableProperties.push(propName);
     }
 
-    if (!target.saveableProperties.includes(key)) {
-      target.saveableProperties.push(key);
-    }
+    logger.log('debug', `called index() on metadata for property ${propName}`);
+
+    // Use addInitializer to ensure prototype arrays are set up once
+    context.addInitializer(function(this: any) {
+      const proto = this.constructor.prototype;
+      const metadata = this.constructor[Symbol.metadata];
+
+      if (metadata && metadata.regularIndexes && !proto.regularIndexes) {
+        proto.regularIndexes = [...metadata.regularIndexes];
+        logger.log('debug', `initialized regularIndexes with ${proto.regularIndexes.length} indexes`);
+      }
+
+      if (metadata && metadata.saveableProperties && !proto.saveableProperties) {
+        proto.saveableProperties = [...metadata.saveableProperties];
+      }
+    });
   };
 }
 

ts/index.ts

@@ -1,3 +1,6 @@
+// Polyfill must be imported first - ES modules hoist exports before code runs
+import './shim.js';
+
 export * from './classes.db.js';
 export * from './classes.collection.js';
 export * from './classes.doc.js';

ts/shim.ts

@@ -0,0 +1,6 @@
+/**
+ * Polyfill for Symbol.metadata required by TC39 Stage 3 decorators.
+ * Must be imported before any decorator code loads.
+ * @see https://github.com/tc39/proposal-decorator-metadata
+ */
+(Symbol as any).metadata ??= Symbol.for('Symbol.metadata');

tsconfig.json

@@ -1,8 +1,6 @@
 {
   "compilerOptions": {
-    "experimentalDecorators": true,
-    "useDefineForClassFields": false,
-    "target": "ES2022",
+    "target": "ES2024",
     "module": "NodeNext",
     "moduleResolution": "NodeNext",
     "esModuleInterop": true,