@objectstack/objectql 4.0.0 → 4.0.2

package/.turbo/turbo-build.log

@@ -1,22 +1,22 @@
 
-> @objectstack/objectql@4.0.0 build /home/runner/work/spec/spec/packages/objectql
+> @objectstack/objectql@4.0.2 build /home/runner/work/framework/framework/packages/objectql
 > tsup --config ../../tsup.config.ts
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.5.1
-CLI Using tsup config: /home/runner/work/spec/spec/tsup.config.ts
+CLI Using tsup config: /home/runner/work/framework/framework/tsup.config.ts
 CLI Target: es2020
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-ESM dist/index.mjs     102.95 KB
-ESM dist/index.mjs.map 211.04 KB
-ESM ⚡️ Build success in 184ms
-CJS dist/index.js     104.68 KB
-CJS dist/index.js.map 212.34 KB
-CJS ⚡️ Build success in 187ms
+CJS dist/index.js     104.57 KB
+CJS dist/index.js.map 212.32 KB
+CJS ⚡️ Build success in 297ms
+ESM dist/index.mjs     102.83 KB
+ESM dist/index.mjs.map 211.02 KB
+ESM ⚡️ Build success in 297ms
 DTS Build start
-DTS ⚡️ Build success in 20424ms
-DTS dist/index.d.mts 79.12 KB
-DTS dist/index.d.ts  79.12 KB
+DTS ⚡️ Build success in 20150ms
+DTS dist/index.d.mts 77.34 KB
+DTS dist/index.d.ts  77.34 KB

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @objectstack/objectql
 
+## 4.0.2
+
+### Patch Changes
+
+- Updated dependencies [5f659e9]
+  - @objectstack/spec@4.0.2
+  - @objectstack/core@4.0.2
+  - @objectstack/types@4.0.2
+
 ## 4.0.0
 
 ### Minor Changes

package/dist/index.d.mts

@@ -130,15 +130,13 @@ declare class SchemaRegistry {
     private static objectContributors;
     /** FQN → Merged ServiceObject (cached, invalidated on changes) */
     private static mergedObjectCache;
-    /** Namespace → PackageId (ensures namespace uniqueness) */
+    /** Namespace → Set<PackageId> (multiple packages can share a namespace) */
     private static namespaceRegistry;
     /** Type → Name/ID → MetadataItem */
     private static metadata;
     /**
      * Register a namespace for a package.
-     * Enforces namespace uniqueness within the instance.
-     *
-     * @throws Error if namespace is already registered to a different package
+     * Multiple packages can share the same namespace (e.g. 'sys').
      */
     static registerNamespace(namespace: string, packageId: string): void;
     /**
@@ -146,9 +144,13 @@ declare class SchemaRegistry {
      */
     static unregisterNamespace(namespace: string, packageId: string): void;
     /**
-     * Get the package that owns a namespace.
+     * Get the packages that use a namespace.
      */
     static getNamespaceOwner(namespace: string): string | undefined;
+    /**
+     * Get all packages that share a namespace.
+     */
+    static getNamespaceOwners(namespace: string): string[];
     /**
      * Register an object with ownership semantics.
      *
@@ -471,11 +473,7 @@ declare class SchemaRegistry {
         keyPrefix?: string | undefined;
         actions?: {
             name: string;
-            label: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            };
+            label: string;
             type: "url" | "script" | "modal" | "flow" | "api";
             refreshAfter: boolean;
             objectName?: string | undefined;
@@ -486,63 +484,35 @@ declare class SchemaRegistry {
             execute?: string | undefined;
             params?: {
                 name: string;
-                label: string | {
-                    key: string;
-                    defaultValue?: string | undefined;
-                    params?: Record<string, string | number | boolean> | undefined;
-                };
+                label: string;
                 type: "number" | "boolean" | "date" | "lookup" | "file" | "url" | "json" | "text" | "textarea" | "email" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
                 required: boolean;
                 options?: {
-                    label: string | {
-                        key: string;
-                        defaultValue?: string | undefined;
-                        params?: Record<string, string | number | boolean> | undefined;
-                    };
+                    label: string;
                     value: string;
                 }[] | undefined;
             }[] | undefined;
             variant?: "link" | "primary" | "secondary" | "danger" | "ghost" | undefined;
-            confirmText?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
-            successMessage?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
+            confirmText?: string | undefined;
+            successMessage?: string | undefined;
             visible?: string | undefined;
             disabled?: string | boolean | undefined;
             shortcut?: string | undefined;
             bulkEnabled?: boolean | undefined;
             timeout?: number | undefined;
             aria?: {
-                ariaLabel?: string | {
-                    key: string;
-                    defaultValue?: string | undefined;
-                    params?: Record<string, string | number | boolean> | undefined;
-                } | undefined;
+                ariaLabel?: string | undefined;
                 ariaDescribedBy?: string | undefined;
                 role?: string | undefined;
             } | undefined;
         }[] | undefined;
     } | {
         name: string;
-        label: string | {
-            key: string;
-            defaultValue?: string | undefined;
-            params?: Record<string, string | number | boolean> | undefined;
-        };
+        label: string;
         active: boolean;
         isDefault: boolean;
         version?: string | undefined;
-        description?: string | {
-            key: string;
-            defaultValue?: string | undefined;
-            params?: Record<string, string | number | boolean> | undefined;
-        } | undefined;
+        description?: string | undefined;
         icon?: string | undefined;
         branding?: {
             primaryColor?: string | undefined;
@@ -552,19 +522,11 @@ declare class SchemaRegistry {
         navigation?: any[] | undefined;
         areas?: {
             id: string;
-            label: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            };
+            label: string;
             navigation: any[];
             icon?: string | undefined;
             order?: number | undefined;
-            description?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
+            description?: string | undefined;
             visible?: string | undefined;
             requiredPermissions?: string[] | undefined;
         }[] | undefined;
@@ -594,11 +556,7 @@ declare class SchemaRegistry {
             bottomNavItems?: string[] | undefined;
         } | undefined;
         aria?: {
-            ariaLabel?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
+            ariaLabel?: string | undefined;
             ariaDescribedBy?: string | undefined;
             role?: string | undefined;
         } | undefined;
@@ -1306,7 +1264,8 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
         };
         services: Record<string, {
             enabled: boolean;
-            status: "degraded" | "stub" | "available" | "unavailable";
+            status: "degraded" | "stub" | "available" | "registered" | "unavailable";
+            handlerReady?: boolean | undefined;
             route?: string | undefined;
             provider?: string | undefined;
             version?: string | undefined;
@@ -1328,6 +1287,7 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
     }>;
     getMetaItems(request: {
         type: string;
+        packageId?: string;
     }): Promise<{
         type: string;
         items: unknown[];
@@ -1335,6 +1295,7 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
     getMetaItem(request: {
         type: string;
         name: string;
+        packageId?: string;
     }): Promise<{
         type: string;
         name: string;
@@ -1384,7 +1345,6 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
         query?: any;
     }): Promise<{
         object: string;
-        value: any[];
         records: any[];
         total: number;
         hasMore: boolean;

package/dist/index.d.ts

@@ -130,15 +130,13 @@ declare class SchemaRegistry {
     private static objectContributors;
     /** FQN → Merged ServiceObject (cached, invalidated on changes) */
     private static mergedObjectCache;
-    /** Namespace → PackageId (ensures namespace uniqueness) */
+    /** Namespace → Set<PackageId> (multiple packages can share a namespace) */
     private static namespaceRegistry;
     /** Type → Name/ID → MetadataItem */
     private static metadata;
     /**
      * Register a namespace for a package.
-     * Enforces namespace uniqueness within the instance.
-     *
-     * @throws Error if namespace is already registered to a different package
+     * Multiple packages can share the same namespace (e.g. 'sys').
      */
     static registerNamespace(namespace: string, packageId: string): void;
     /**
@@ -146,9 +144,13 @@ declare class SchemaRegistry {
      */
     static unregisterNamespace(namespace: string, packageId: string): void;
     /**
-     * Get the package that owns a namespace.
+     * Get the packages that use a namespace.
      */
     static getNamespaceOwner(namespace: string): string | undefined;
+    /**
+     * Get all packages that share a namespace.
+     */
+    static getNamespaceOwners(namespace: string): string[];
     /**
      * Register an object with ownership semantics.
      *
@@ -471,11 +473,7 @@ declare class SchemaRegistry {
         keyPrefix?: string | undefined;
         actions?: {
             name: string;
-            label: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            };
+            label: string;
             type: "url" | "script" | "modal" | "flow" | "api";
             refreshAfter: boolean;
             objectName?: string | undefined;
@@ -486,63 +484,35 @@ declare class SchemaRegistry {
             execute?: string | undefined;
             params?: {
                 name: string;
-                label: string | {
-                    key: string;
-                    defaultValue?: string | undefined;
-                    params?: Record<string, string | number | boolean> | undefined;
-                };
+                label: string;
                 type: "number" | "boolean" | "date" | "lookup" | "file" | "url" | "json" | "text" | "textarea" | "email" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
                 required: boolean;
                 options?: {
-                    label: string | {
-                        key: string;
-                        defaultValue?: string | undefined;
-                        params?: Record<string, string | number | boolean> | undefined;
-                    };
+                    label: string;
                     value: string;
                 }[] | undefined;
             }[] | undefined;
             variant?: "link" | "primary" | "secondary" | "danger" | "ghost" | undefined;
-            confirmText?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
-            successMessage?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
+            confirmText?: string | undefined;
+            successMessage?: string | undefined;
             visible?: string | undefined;
             disabled?: string | boolean | undefined;
             shortcut?: string | undefined;
             bulkEnabled?: boolean | undefined;
             timeout?: number | undefined;
             aria?: {
-                ariaLabel?: string | {
-                    key: string;
-                    defaultValue?: string | undefined;
-                    params?: Record<string, string | number | boolean> | undefined;
-                } | undefined;
+                ariaLabel?: string | undefined;
                 ariaDescribedBy?: string | undefined;
                 role?: string | undefined;
             } | undefined;
         }[] | undefined;
     } | {
         name: string;
-        label: string | {
-            key: string;
-            defaultValue?: string | undefined;
-            params?: Record<string, string | number | boolean> | undefined;
-        };
+        label: string;
         active: boolean;
         isDefault: boolean;
         version?: string | undefined;
-        description?: string | {
-            key: string;
-            defaultValue?: string | undefined;
-            params?: Record<string, string | number | boolean> | undefined;
-        } | undefined;
+        description?: string | undefined;
         icon?: string | undefined;
         branding?: {
             primaryColor?: string | undefined;
@@ -552,19 +522,11 @@ declare class SchemaRegistry {
         navigation?: any[] | undefined;
         areas?: {
             id: string;
-            label: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            };
+            label: string;
             navigation: any[];
             icon?: string | undefined;
             order?: number | undefined;
-            description?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
+            description?: string | undefined;
             visible?: string | undefined;
             requiredPermissions?: string[] | undefined;
         }[] | undefined;
@@ -594,11 +556,7 @@ declare class SchemaRegistry {
             bottomNavItems?: string[] | undefined;
         } | undefined;
         aria?: {
-            ariaLabel?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
+            ariaLabel?: string | undefined;
             ariaDescribedBy?: string | undefined;
             role?: string | undefined;
         } | undefined;
@@ -1306,7 +1264,8 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
         };
         services: Record<string, {
             enabled: boolean;
-            status: "degraded" | "stub" | "available" | "unavailable";
+            status: "degraded" | "stub" | "available" | "registered" | "unavailable";
+            handlerReady?: boolean | undefined;
             route?: string | undefined;
             provider?: string | undefined;
             version?: string | undefined;
@@ -1328,6 +1287,7 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
     }>;
     getMetaItems(request: {
         type: string;
+        packageId?: string;
     }): Promise<{
         type: string;
         items: unknown[];
@@ -1335,6 +1295,7 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
     getMetaItem(request: {
         type: string;
         name: string;
+        packageId?: string;
     }): Promise<{
         type: string;
         name: string;
@@ -1384,7 +1345,6 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
         query?: any;
     }): Promise<{
         object: string;
-        value: any[];
         records: any[];
         total: number;
         hasMore: boolean;

package/dist/index.js

@@ -93,36 +93,45 @@ var SchemaRegistry = class {
   // ==========================================
   /**
    * Register a namespace for a package.
-   * Enforces namespace uniqueness within the instance.
-   * 
-   * @throws Error if namespace is already registered to a different package
+   * Multiple packages can share the same namespace (e.g. 'sys').
    */
   static registerNamespace(namespace, packageId) {
     if (!namespace) return;
-    const existing = this.namespaceRegistry.get(namespace);
-    if (existing && existing !== packageId) {
-      throw new Error(
-        `Namespace "${namespace}" is already registered to package "${existing}". Package "${packageId}" cannot use the same namespace.`
-      );
+    let owners = this.namespaceRegistry.get(namespace);
+    if (!owners) {
+      owners = /* @__PURE__ */ new Set();
+      this.namespaceRegistry.set(namespace, owners);
     }
-    this.namespaceRegistry.set(namespace, packageId);
+    owners.add(packageId);
     this.log(`[Registry] Registered namespace: ${namespace} \u2192 ${packageId}`);
   }
   /**
    * Unregister a namespace when a package is uninstalled.
    */
   static unregisterNamespace(namespace, packageId) {
-    const existing = this.namespaceRegistry.get(namespace);
-    if (existing === packageId) {
-      this.namespaceRegistry.delete(namespace);
-      this.log(`[Registry] Unregistered namespace: ${namespace}`);
+    const owners = this.namespaceRegistry.get(namespace);
+    if (owners) {
+      owners.delete(packageId);
+      if (owners.size === 0) {
+        this.namespaceRegistry.delete(namespace);
+      }
+      this.log(`[Registry] Unregistered namespace: ${namespace} \u2190 ${packageId}`);
     }
   }
   /**
-   * Get the package that owns a namespace.
+   * Get the packages that use a namespace.
    */
   static getNamespaceOwner(namespace) {
-    return this.namespaceRegistry.get(namespace);
+    const owners = this.namespaceRegistry.get(namespace);
+    if (!owners || owners.size === 0) return void 0;
+    return owners.values().next().value;
+  }
+  /**
+   * Get all packages that share a namespace.
+   */
+  static getNamespaceOwners(namespace) {
+    const owners = this.namespaceRegistry.get(namespace);
+    return owners ? Array.from(owners) : [];
   }
   // ==========================================
   // Object Registration (Ownership Model)
@@ -534,7 +543,7 @@ SchemaRegistry._logLevel = "info";
 SchemaRegistry.objectContributors = /* @__PURE__ */ new Map();
 /** FQN → Merged ServiceObject (cached, invalidated on changes) */
 SchemaRegistry.mergedObjectCache = /* @__PURE__ */ new Map();
-/** Namespace → PackageId (ensures namespace uniqueness) */
+/** Namespace → Set<PackageId> (multiple packages can share a namespace) */
 SchemaRegistry.namespaceRegistry = /* @__PURE__ */ new Map();
 // ==========================================
 // Generic metadata storage (non-object types)
@@ -676,15 +685,18 @@ var ObjectStackProtocolImplementation = class {
     };
   }
   async getMetaItems(request) {
-    let items = SchemaRegistry.listItems(request.type);
+    const { packageId } = request;
+    let items = SchemaRegistry.listItems(request.type, packageId);
     if (items.length === 0) {
       const alt = request.type.endsWith("s") ? request.type.slice(0, -1) : request.type + "s";
-      items = SchemaRegistry.listItems(alt);
+      items = SchemaRegistry.listItems(alt, packageId);
     }
     if (items.length === 0) {
       try {
+        const whereClause = { type: request.type, state: "active" };
+        if (packageId) whereClause._packageId = packageId;
         const allRecords = await this.engine.find("sys_metadata", {
-          where: { type: request.type, state: "active" }
+          where: whereClause
         });
         if (allRecords && allRecords.length > 0) {
           items = allRecords.map((record) => {
@@ -912,10 +924,7 @@ var ObjectStackProtocolImplementation = class {
     const records = await this.engine.find(request.object, options);
     return {
       object: request.object,
-      value: records,
-      // OData compatibility
       records,
-      // Legacy
       total: records.length,
       hasMore: false
     };
@@ -2720,38 +2729,18 @@ var ObjectQLPlugin = class {
         this.ql = new ObjectQL(hostCtx);
       }
       ctx.registerService("objectql", this.ql);
-      let hasMetadata = false;
-      let metadataProvider = "objectql";
-      try {
-        if (ctx.getService("metadata")) {
-          hasMetadata = true;
-          metadataProvider = "external";
-        }
-      } catch (e) {
-      }
-      if (!hasMetadata) {
-        try {
-          const metadataFacade = new MetadataFacade();
-          ctx.registerService("metadata", metadataFacade);
-          ctx.logger.info("MetadataFacade registered as metadata service", {
-            mode: "in-memory",
-            features: ["registry", "fast-lookup"]
+      ctx.registerService("data", this.ql);
+      const ql = this.ql;
+      ctx.registerService("manifest", {
+        register: (manifest) => {
+          ql.registerApp(manifest);
+          ctx.logger.debug("Manifest registered via manifest service", {
+            id: manifest.id || manifest.name
           });
-        } catch (e) {
-          if (!e.message?.includes("already registered")) {
-            throw e;
-          }
         }
-      } else {
-        ctx.logger.info("External metadata service detected", {
-          provider: metadataProvider,
-          mode: "will-sync-in-start-phase"
-        });
-      }
-      ctx.registerService("data", this.ql);
+      });
       ctx.logger.info("ObjectQL engine registered", {
-        services: ["objectql", "data"],
-        metadataProvider
+        services: ["objectql", "data", "manifest"]
       });
       const protocolShim = new ObjectStackProtocolImplementation(
         this.ql,
@@ -2764,7 +2753,7 @@ var ObjectQLPlugin = class {
       ctx.logger.info("ObjectQL engine starting...");
       try {
         const metadataService = ctx.getService("metadata");
-        if (metadataService && !(metadataService instanceof MetadataFacade) && this.ql) {
+        if (metadataService && typeof metadataService.loadMany === "function" && this.ql) {
           await this.loadMetadataFromService(metadataService, ctx);
         }
       } catch (e) {
@@ -2778,8 +2767,11 @@ var ObjectQLPlugin = class {
             ctx.logger.debug("Discovered and registered driver service", { serviceName: name });
           }
           if (name.startsWith("app.")) {
+            ctx.logger.warn(
+              `[DEPRECATED] Service "${name}" uses legacy app.* convention. Migrate to ctx.getService('manifest').register(data).`
+            );
             this.ql.registerApp(service);
-            ctx.logger.debug("Discovered and registered app service", { serviceName: name });
+            ctx.logger.debug("Discovered and registered app service (legacy)", { serviceName: name });
           }
         }
       }