@objectstack/metadata 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @objectstack/metadata
 
+## 1.0.2
+
+### Patch Changes
+
+- a0a6c85: Infrastructure and development tooling improvements
+
+  - Add changeset configuration for automated version management
+  - Add comprehensive GitHub Actions workflows (CI, CodeQL, linting, releases)
+  - Add development configuration files (.cursorrules, .github/prompts)
+  - Add documentation files (ARCHITECTURE.md, CONTRIBUTING.md, workflows docs)
+  - Update test script configuration in package.json
+  - Add @objectstack/cli to devDependencies for better development experience
+
+- 109fc5b: Unified patch release to align all package versions.
+- Updated dependencies [a0a6c85]
+- Updated dependencies [109fc5b]
+  - @objectstack/spec@1.0.2
+  - @objectstack/core@1.0.2
+  - @objectstack/types@1.0.2
+
+## 1.0.1
+
+### Patch Changes
+
+- @objectstack/spec@1.0.1
+- @objectstack/core@1.0.1
+- @objectstack/types@1.0.1
+
 ## 1.0.0
 
 ### Major Changes

package/dist/index.d.ts

@@ -3,10 +3,11 @@
  *
  * Metadata loading, saving, and persistence for ObjectStack
  */
-export { MetadataManager, type WatchCallback } from './metadata-manager.js';
+export { MetadataManager, type WatchCallback, type MetadataManagerOptions } from './metadata-manager.js';
 export { MetadataPlugin } from './plugin.js';
 export { type MetadataLoader } from './loaders/loader-interface.js';
-export { FilesystemLoader } from './loaders/filesystem-loader.js';
+export { MemoryLoader } from './loaders/memory-loader.js';
+export { RemoteLoader } from './loaders/remote-loader.js';
 export { type MetadataSerializer, type SerializeOptions } from './serializers/serializer-interface.js';
 export { JSONSerializer } from './serializers/json-serializer.js';
 export { YAMLSerializer } from './serializers/yaml-serializer.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG5E,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGlE,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACvG,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAG9E,YAAY,EACV,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAGzG,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG1D,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACvG,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAG9E,YAAY,EACV,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -7,7 +7,8 @@
 export { MetadataManager } from './metadata-manager.js';
 // Plugin
 export { MetadataPlugin } from './plugin.js';
-export { FilesystemLoader } from './loaders/filesystem-loader.js';
+export { MemoryLoader } from './loaders/memory-loader.js';
+export { RemoteLoader } from './loaders/remote-loader.js';
 export { JSONSerializer } from './serializers/json-serializer.js';
 export { YAMLSerializer } from './serializers/yaml-serializer.js';
 export * as Migration from './migration/index.js';

package/dist/loaders/filesystem-loader.d.ts

@@ -3,7 +3,7 @@
  *
  * Loads metadata from the filesystem using glob patterns
  */
-import type { MetadataLoadOptions, MetadataLoadResult, MetadataStats, MetadataLoaderContract, MetadataFormat } from '@objectstack/spec/system';
+import type { MetadataLoadOptions, MetadataLoadResult, MetadataStats, MetadataLoaderContract, MetadataFormat, MetadataSaveOptions, MetadataSaveResult } from '@objectstack/spec/system';
 import type { Logger } from '@objectstack/core';
 import type { MetadataLoader } from './loader-interface.js';
 import type { MetadataSerializer } from '../serializers/serializer-interface.js';
@@ -19,6 +19,7 @@ export declare class FilesystemLoader implements MetadataLoader {
     exists(type: string, name: string): Promise<boolean>;
     stat(type: string, name: string): Promise<MetadataStats | null>;
     list(type: string): Promise<string[]>;
+    save(type: string, name: string, data: any, options?: MetadataSaveOptions): Promise<MetadataSaveResult>;
     /**
      * Find file for a given type and name
      */

package/dist/loaders/filesystem-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem-loader.d.ts","sourceRoot":"","sources":["../../src/loaders/filesystem-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,cAAc,EACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAEjF,qBAAa,gBAAiB,YAAW,cAAc;IAmBnD,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,MAAM,CAAC;IApBjB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAavC;IAEF,OAAO,CAAC,KAAK,CAAqE;gBAGxE,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,EACpD,MAAM,CAAC,EAAE,MAAM,YAAA;IAGnB,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IA8FxB,QAAQ,CAAC,CAAC,GAAG,GAAG,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC;IAwDT,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKpD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA+B/D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwB3C;;OAEG;YACW,QAAQ;IAkBtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAIrB"}
+{"version":3,"file":"filesystem-loader.d.ts","sourceRoot":"","sources":["../../src/loaders/filesystem-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAEjF,qBAAa,gBAAiB,YAAW,cAAc;IAmBnD,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,MAAM,CAAC;IApBjB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAavC;IAEF,OAAO,CAAC,KAAK,CAAqE;gBAGxE,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,EACpD,MAAM,CAAC,EAAE,MAAM,YAAA;IAGnB,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IA8FxB,QAAQ,CAAC,CAAC,GAAG,GAAG,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC;IAwDT,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKpD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA+B/D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwBrC,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EACT,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IA0F9B;;OAEG;YACW,QAAQ;IAkBtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAIrB"}

package/dist/loaders/filesystem-loader.js

@@ -212,6 +212,81 @@ export class FilesystemLoader {
             return [];
         }
     }
+    async save(type, name, data, options) {
+        const startTime = Date.now();
+        const { format = 'typescript', prettify = true, indent = 2, sortKeys = false, backup = false, overwrite = true, atomic = true, path: customPath, } = options || {};
+        try {
+            // Get serializer
+            const serializer = this.getSerializer(format);
+            if (!serializer) {
+                throw new Error(`No serializer found for format: ${format}`);
+            }
+            // Determine file path
+            const typeDir = path.join(this.rootDir, type);
+            const fileName = `${name}${serializer.getExtension()}`;
+            const filePath = customPath || path.join(typeDir, fileName);
+            // Check if file exists
+            if (!overwrite) {
+                try {
+                    await fs.access(filePath);
+                    throw new Error(`File already exists: ${filePath}`);
+                }
+                catch (error) {
+                    // File doesn't exist, continue
+                    if (error.code !== 'ENOENT') {
+                        throw error;
+                    }
+                }
+            }
+            // Create directory if it doesn't exist
+            await fs.mkdir(path.dirname(filePath), { recursive: true });
+            // Create backup if requested
+            let backupPath;
+            if (backup) {
+                try {
+                    await fs.access(filePath);
+                    backupPath = `${filePath}.bak`;
+                    await fs.copyFile(filePath, backupPath);
+                }
+                catch {
+                    // File doesn't exist, no backup needed
+                }
+            }
+            // Serialize data
+            const content = serializer.serialize(data, {
+                prettify,
+                indent,
+                sortKeys,
+            });
+            // Write to disk (atomic or direct)
+            if (atomic) {
+                const tempPath = `${filePath}.tmp`;
+                await fs.writeFile(tempPath, content, 'utf-8');
+                await fs.rename(tempPath, filePath);
+            }
+            else {
+                await fs.writeFile(filePath, content, 'utf-8');
+            }
+            // Update cache logic if needed (e.g., invalidate or update)
+            // For now, we rely on the watcher to pick up changes
+            return {
+                success: true,
+                path: filePath,
+                // format, // Not in schema
+                size: Buffer.byteLength(content, 'utf-8'),
+                backupPath,
+                saveTime: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            this.logger?.error('Failed to save metadata', undefined, {
+                type,
+                name,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
     /**
      * Find file for a given type and name
      */

package/dist/loaders/loader-interface.d.ts

@@ -3,7 +3,7 @@
  *
  * Defines the contract for loading metadata from various sources
  */
-import type { MetadataLoadOptions, MetadataLoadResult, MetadataStats, MetadataLoaderContract } from '@objectstack/spec/system';
+import type { MetadataLoadOptions, MetadataLoadResult, MetadataStats, MetadataLoaderContract, MetadataSaveOptions, MetadataSaveResult } from '@objectstack/spec/system';
 /**
  * Abstract interface for metadata loaders
  * Implementations can load from filesystem, HTTP, S3, databases, etc.
@@ -48,5 +48,13 @@ export interface MetadataLoader {
      * @returns Array of item names
      */
     list(type: string): Promise<string[]>;
+    /**
+     * Save metadata item
+     * @param type The metadata type
+     * @param name The item name
+     * @param data The data to save
+     * @param options Save options
+     */
+    save?(type: string, name: string, data: any, options?: MetadataSaveOptions): Promise<MetadataSaveResult>;
 }
 //# sourceMappingURL=loader-interface.d.ts.map

package/dist/loaders/loader-interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader-interface.d.ts","sourceRoot":"","sources":["../../src/loaders/loader-interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAE1C;;;;;;OAMG;IACH,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/B;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,GAAG,GAAG,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAEhB;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErD;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAEhE;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACvC"}
+{"version":3,"file":"loader-interface.d.ts","sourceRoot":"","sources":["../../src/loaders/loader-interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAE1C;;;;;;OAMG;IACH,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/B;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,GAAG,GAAG,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAEhB;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErD;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAEhE;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEtC;;;;;;OAMG;IACH,IAAI,CAAC,CACH,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EACT,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChC"}

package/dist/loaders/memory-loader.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Memory Metadata Loader
+ *
+ * Stores metadata in memory only. Changes are lost when process restarts.
+ * Useful for testing, temporary overrides, or "dirty" edits.
+ */
+import type { MetadataLoadOptions, MetadataLoadResult, MetadataStats, MetadataLoaderContract, MetadataSaveOptions, MetadataSaveResult } from '@objectstack/spec/system';
+import type { MetadataLoader } from './loader-interface.js';
+export declare class MemoryLoader implements MetadataLoader {
+    readonly contract: MetadataLoaderContract;
+    private storage;
+    load(type: string, name: string, _options?: MetadataLoadOptions): Promise<MetadataLoadResult>;
+    loadMany<T = any>(type: string, _options?: MetadataLoadOptions): Promise<T[]>;
+    exists(type: string, name: string): Promise<boolean>;
+    stat(type: string, name: string): Promise<MetadataStats | null>;
+    list(type: string): Promise<string[]>;
+    save(type: string, name: string, data: any, _options?: MetadataSaveOptions): Promise<MetadataSaveResult>;
+}
+//# sourceMappingURL=memory-loader.d.ts.map

package/dist/loaders/memory-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-loader.d.ts","sourceRoot":"","sources":["../../src/loaders/memory-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,qBAAa,YAAa,YAAW,cAAc;IACjD,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CASvC;IAGF,OAAO,CAAC,OAAO,CAAuC;IAEhD,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAAC,kBAAkB,CAAC;IAgBxB,QAAQ,CAAC,CAAC,GAAG,GAAG,EACpB,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAAC,CAAC,EAAE,CAAC;IAMT,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAW/D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMrC,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EACT,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAAC,kBAAkB,CAAC;CAa/B"}

package/dist/loaders/memory-loader.js

@@ -0,0 +1,71 @@
+/**
+ * Memory Metadata Loader
+ *
+ * Stores metadata in memory only. Changes are lost when process restarts.
+ * Useful for testing, temporary overrides, or "dirty" edits.
+ */
+export class MemoryLoader {
+    constructor() {
+        this.contract = {
+            name: 'memory',
+            protocol: 'memory',
+            capabilities: {
+                read: true,
+                write: true,
+                watch: false,
+                list: true,
+            },
+        };
+        // Storage: Type -> Name -> Data
+        this.storage = new Map();
+    }
+    async load(type, name, _options) {
+        const typeStore = this.storage.get(type);
+        const data = typeStore?.get(name);
+        if (data) {
+            return {
+                data,
+                source: 'memory',
+                format: 'json',
+                loadTime: 0,
+            };
+        }
+        return { data: null };
+    }
+    async loadMany(type, _options) {
+        const typeStore = this.storage.get(type);
+        if (!typeStore)
+            return [];
+        return Array.from(typeStore.values());
+    }
+    async exists(type, name) {
+        return this.storage.get(type)?.has(name) ?? false;
+    }
+    async stat(type, name) {
+        if (await this.exists(type, name)) {
+            return {
+                size: 0, // In-memory
+                mtime: new Date(),
+                format: 'json',
+            };
+        }
+        return null;
+    }
+    async list(type) {
+        const typeStore = this.storage.get(type);
+        if (!typeStore)
+            return [];
+        return Array.from(typeStore.keys());
+    }
+    async save(type, name, data, _options) {
+        if (!this.storage.has(type)) {
+            this.storage.set(type, new Map());
+        }
+        this.storage.get(type).set(name, data);
+        return {
+            success: true,
+            path: `memory://${type}/${name}`,
+            saveTime: 0,
+        };
+    }
+}

package/dist/loaders/remote-loader.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Remote Metadata Loader
+ *
+ * Loads metadata from an HTTP API.
+ * This loader is stateless and delegates storage to the remote server.
+ */
+import type { MetadataLoadOptions, MetadataLoadResult, MetadataStats, MetadataLoaderContract, MetadataSaveOptions, MetadataSaveResult } from '@objectstack/spec/system';
+import type { MetadataLoader } from './loader-interface.js';
+export declare class RemoteLoader implements MetadataLoader {
+    private baseUrl;
+    private authToken?;
+    readonly contract: MetadataLoaderContract;
+    constructor(baseUrl: string, authToken?: string | undefined);
+    private get headers();
+    load(type: string, name: string, _options?: MetadataLoadOptions): Promise<MetadataLoadResult>;
+    loadMany<T = any>(type: string, _options?: MetadataLoadOptions): Promise<T[]>;
+    exists(type: string, name: string): Promise<boolean>;
+    stat(type: string, name: string): Promise<MetadataStats | null>;
+    list(type: string): Promise<string[]>;
+    save(type: string, name: string, data: any, _options?: MetadataSaveOptions): Promise<MetadataSaveResult>;
+}
+//# sourceMappingURL=remote-loader.d.ts.map

package/dist/loaders/remote-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-loader.d.ts","sourceRoot":"","sources":["../../src/loaders/remote-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,qBAAa,YAAa,YAAW,cAAc;IAYrC,OAAO,CAAC,OAAO;IAAU,OAAO,CAAC,SAAS,CAAC;IAXvD,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CASvC;gBAEkB,OAAO,EAAE,MAAM,EAAU,SAAS,CAAC,EAAE,MAAM,YAAA;IAE/D,OAAO,KAAK,OAAO,GAKlB;IAEK,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAAC,kBAAkB,CAAC;IA4BxB,QAAQ,CAAC,CAAC,GAAG,GAAG,EACpB,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAAC,CAAC,EAAE,CAAC;IAaT,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQpD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAgB/D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKrC,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EACT,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAAC,kBAAkB,CAAC;CAiB/B"}

package/dist/loaders/remote-loader.js

@@ -0,0 +1,103 @@
+/**
+ * Remote Metadata Loader
+ *
+ * Loads metadata from an HTTP API.
+ * This loader is stateless and delegates storage to the remote server.
+ */
+export class RemoteLoader {
+    constructor(baseUrl, authToken) {
+        this.baseUrl = baseUrl;
+        this.authToken = authToken;
+        this.contract = {
+            name: 'remote',
+            protocol: 'http',
+            capabilities: {
+                read: true,
+                write: true,
+                watch: false, // Could implement SSE/WebSocket in future
+                list: true,
+            },
+        };
+    }
+    get headers() {
+        return {
+            'Content-Type': 'application/json',
+            ...(this.authToken ? { Authorization: `Bearer ${this.authToken}` } : {}),
+        };
+    }
+    async load(type, name, _options) {
+        try {
+            const response = await fetch(`${this.baseUrl}/${type}/${name}`, {
+                method: 'GET',
+                headers: this.headers,
+            });
+            if (response.status === 404) {
+                return { data: null };
+            }
+            if (!response.ok) {
+                throw new Error(`Remote load failed: ${response.statusText}`);
+            }
+            const data = await response.json();
+            return {
+                data,
+                source: this.baseUrl,
+                format: 'json',
+                loadTime: 0,
+            };
+        }
+        catch (error) {
+            console.error(`RemoteLoader error loading ${type}/${name}`, error);
+            throw error;
+        }
+    }
+    async loadMany(type, _options) {
+        const response = await fetch(`${this.baseUrl}/${type}`, {
+            method: 'GET',
+            headers: this.headers,
+        });
+        if (!response.ok) {
+            return [];
+        }
+        return (await response.json());
+    }
+    async exists(type, name) {
+        const response = await fetch(`${this.baseUrl}/${type}/${name}`, {
+            method: 'HEAD',
+            headers: this.headers,
+        });
+        return response.ok;
+    }
+    async stat(type, name) {
+        // Basic implementation using HEAD
+        const response = await fetch(`${this.baseUrl}/${type}/${name}`, {
+            method: 'HEAD',
+            headers: this.headers,
+        });
+        if (!response.ok)
+            return null;
+        return {
+            size: Number(response.headers.get('content-length') || 0),
+            mtime: new Date(response.headers.get('last-modified') || Date.now()),
+            format: 'json',
+        };
+    }
+    async list(type) {
+        const items = await this.loadMany(type);
+        return items.map(i => i.name);
+    }
+    async save(type, name, data, _options) {
+        const response = await fetch(`${this.baseUrl}/${type}/${name}`, {
+            method: 'PUT',
+            headers: this.headers,
+            body: JSON.stringify(data),
+        });
+        if (!response.ok) {
+            throw new Error(`Remote save failed: ${response.statusText}`);
+        }
+        return {
+            success: true,
+            path: `${this.baseUrl}/${type}/${name}`,
+            saveTime: 0,
+        };
+    }
+}

package/dist/metadata-manager.d.ts

@@ -1,35 +1,50 @@
 /**
  * Metadata Manager
  *
- * Main orchestrator for metadata loading, saving, and persistence
+ * Main orchestrator for metadata loading, saving, and persistence.
+ * Browser-compatible (Pure).
  */
-import type { MetadataManagerConfig, MetadataLoadOptions, MetadataSaveOptions, MetadataSaveResult, MetadataWatchEvent } from '@objectstack/spec/system';
+import type { MetadataManagerConfig, MetadataLoadOptions, MetadataSaveOptions, MetadataSaveResult, MetadataWatchEvent, MetadataFormat } from '@objectstack/spec/system';
+import { type Logger } from '@objectstack/core';
+import type { MetadataSerializer } from './serializers/serializer-interface.js';
+import type { MetadataLoader } from './loaders/loader-interface.js';
 /**
  * Watch callback function
  */
 export type WatchCallback = (event: MetadataWatchEvent) => void | Promise<void>;
+export interface MetadataManagerOptions extends MetadataManagerConfig {
+    loaders?: MetadataLoader[];
+}
 /**
  * Main metadata manager class
  */
 export declare class MetadataManager {
-    private config;
-    private loader;
-    private serializers;
-    private logger;
-    private watcher?;
-    private watchCallbacks;
-    constructor(config: MetadataManagerConfig);
+    private loaders;
+    protected serializers: Map<MetadataFormat, MetadataSerializer>;
+    protected logger: Logger;
+    protected watchCallbacks: Map<string, Set<WatchCallback>>;
+    protected config: MetadataManagerOptions;
+    constructor(config: MetadataManagerOptions);
+    /**
+     * Register a new metadata loader (data source)
+     */
+    registerLoader(loader: MetadataLoader): void;
     /**
      * Load a single metadata item
+     * Iterates through registered loaders until found
      */
     load<T = any>(type: string, name: string, options?: MetadataLoadOptions): Promise<T | null>;
     /**
      * Load multiple metadata items
+     * Aggregates results from all loaders
      */
     loadMany<T = any>(type: string, options?: MetadataLoadOptions): Promise<T[]>;
     /**
      * Save metadata to disk
      */
+    /**
+     * Save metadata item
+     */
     save<T = any>(type: string, name: string, data: T, options?: MetadataSaveOptions): Promise<MetadataSaveResult>;
     /**
      * Check if metadata item exists
@@ -51,19 +66,6 @@ export declare class MetadataManager {
      * Stop all watching
      */
     stopWatching(): Promise<void>;
-    /**
-     * Start watching for file changes
-     */
-    private startWatching;
-    /**
-     * Handle file change events
-     */
-    private handleFileEvent;
-    /**
-     * Generate ETag for content
-     * Uses SHA-256 hash truncated to 32 characters for reasonable collision resistance
-     * while keeping ETag headers compact (full 64-char hash is overkill for this use case)
-     */
-    private generateETag;
+    protected notifyWatchers(type: string, event: MetadataWatchEvent): void;
 }
 //# sourceMappingURL=metadata-manager.d.ts.map

package/dist/metadata-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-manager.d.ts","sourceRoot":"","sources":["../src/metadata-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAEnB,MAAM,0BAA0B,CAAC;AASlC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhF;;GAEG;AACH,qBAAa,eAAe;IAOd,OAAO,CAAC,MAAM;IAN1B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,WAAW,CAA0C;IAC7D,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAC,CAAY;IAC5B,OAAO,CAAC,cAAc,CAAyC;gBAE3C,MAAM,EAAE,qBAAqB;IA8BjD;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,GAAG,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKpB;;OAEG;IACG,QAAQ,CAAC,CAAC,GAAG,GAAG,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC;IAIf;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,GAAG,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IA2F9B;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1D;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI3C;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAOlD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAUpD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnC;;OAEG;IACH,OAAO,CAAC,aAAa;IA0BrB;;OAEG;YACW,eAAe;IAwD7B;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAIrB"}
+{"version":3,"file":"metadata-manager.d.ts","sourceRoot":"","sources":["../src/metadata-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhF,MAAM,WAAW,sBAAuB,SAAQ,qBAAqB;IACnE,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAA0C;IAEzD,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IAC/D,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,cAAc,kCAAyC;IACjE,SAAS,CAAC,MAAM,EAAE,sBAAsB,CAAC;gBAE7B,MAAM,EAAE,sBAAsB;IA4B1C;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,cAAc;IAKrC;;;OAGG;IACG,IAAI,CAAC,CAAC,GAAG,GAAG,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAgBpB;;;OAGG;IACG,QAAQ,CAAC,CAAC,GAAG,GAAG,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC;IAiBf;;OAEG;IACH;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,GAAG,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IA0D9B;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS1D;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAS3C;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAOlD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAUpD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB;CAejE"}