@objectstack/objectql 7.2.1 → 7.3.0

package/dist/index.d.mts

@@ -138,6 +138,21 @@ declare class SchemaRegistry {
     private namespaceRegistry;
     /** Type → Name/ID → MetadataItem */
     private metadata;
+    /**
+     * Package ids that must be installed in a DISABLED state. Seeded once at
+     * boot (from persisted state) BEFORE any package registration so that every
+     * registration path — boot artifact, marketplace rehydrate, local import —
+     * honors persisted disable state uniformly without a fragile post-boot
+     * re-application hook. See {@link setInitialDisabledPackageIds} and
+     * {@link installPackage}.
+     */
+    private initialDisabledPackageIds;
+    /**
+     * Seed the set of package ids that should be installed disabled. Call this
+     * before package registration begins; later `installPackage` calls for these
+     * ids land in the `disabled` state. Replaces any previously seeded set.
+     */
+    setInitialDisabledPackageIds(ids: Iterable<string>): void;
     /**
      * Register a namespace for a package.
      * Multiple packages can share the same namespace (e.g. 'sys').
@@ -226,6 +241,11 @@ declare class SchemaRegistry {
      * Universal List Method
      */
     listItems<T>(type: string, packageId?: string): T[];
+    /**
+     * Whether a package has been explicitly disabled. Unknown packages and
+     * items with no owning package are treated as enabled.
+     */
+    isPackageDisabled(packageId?: string): boolean;
     /**
      * Get all registered metadata types (Kinds)
      */
@@ -977,6 +997,7 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
         actor?: string;
         force?: boolean;
         mode?: 'draft' | 'publish';
+        packageId?: string | null;
     }): Promise<{
         success: boolean;
         version: string;

package/dist/index.d.ts

@@ -138,6 +138,21 @@ declare class SchemaRegistry {
     private namespaceRegistry;
     /** Type → Name/ID → MetadataItem */
     private metadata;
+    /**
+     * Package ids that must be installed in a DISABLED state. Seeded once at
+     * boot (from persisted state) BEFORE any package registration so that every
+     * registration path — boot artifact, marketplace rehydrate, local import —
+     * honors persisted disable state uniformly without a fragile post-boot
+     * re-application hook. See {@link setInitialDisabledPackageIds} and
+     * {@link installPackage}.
+     */
+    private initialDisabledPackageIds;
+    /**
+     * Seed the set of package ids that should be installed disabled. Call this
+     * before package registration begins; later `installPackage` calls for these
+     * ids land in the `disabled` state. Replaces any previously seeded set.
+     */
+    setInitialDisabledPackageIds(ids: Iterable<string>): void;
     /**
      * Register a namespace for a package.
      * Multiple packages can share the same namespace (e.g. 'sys').
@@ -226,6 +241,11 @@ declare class SchemaRegistry {
      * Universal List Method
      */
     listItems<T>(type: string, packageId?: string): T[];
+    /**
+     * Whether a package has been explicitly disabled. Unknown packages and
+     * items with no owning package are treated as enabled.
+     */
+    isPackageDisabled(packageId?: string): boolean;
     /**
      * Get all registered metadata types (Kinds)
      */
@@ -977,6 +997,7 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
         actor?: string;
         force?: boolean;
         mode?: 'draft' | 'publish';
+        packageId?: string | null;
     }): Promise<{
         success: boolean;
         version: string;

package/dist/index.js

@@ -178,6 +178,15 @@ var SchemaRegistry = class {
     // ==========================================
     /** Type → Name/ID → MetadataItem */
     this.metadata = /* @__PURE__ */ new Map();
+    /**
+     * Package ids that must be installed in a DISABLED state. Seeded once at
+     * boot (from persisted state) BEFORE any package registration so that every
+     * registration path — boot artifact, marketplace rehydrate, local import —
+     * honors persisted disable state uniformly without a fragile post-boot
+     * re-application hook. See {@link setInitialDisabledPackageIds} and
+     * {@link installPackage}.
+     */
+    this.initialDisabledPackageIds = /* @__PURE__ */ new Set();
     if (options.multiTenant !== void 0) {
       this.multiTenant = options.multiTenant;
     } else {
@@ -194,6 +203,14 @@ var SchemaRegistry = class {
     if (this._logLevel === "silent" || this._logLevel === "error" || this._logLevel === "warn") return;
     console.log(msg);
   }
+  /**
+   * Seed the set of package ids that should be installed disabled. Call this
+   * before package registration begins; later `installPackage` calls for these
+   * ids land in the `disabled` state. Replaces any previously seeded set.
+   */
+  setInitialDisabledPackageIds(ids) {
+    this.initialDisabledPackageIds = new Set(ids);
+  }
   // ==========================================
   // Namespace Management
   // ==========================================
@@ -519,10 +536,23 @@ var SchemaRegistry = class {
       return this.getAllObjects(packageId);
     }
     const items = Array.from(this.metadata.get(type)?.values() || []);
+    let result = items;
     if (packageId) {
-      return items.filter((item) => item._packageId === packageId);
+      result = result.filter((item) => item._packageId === packageId);
     }
-    return items;
+    if (type !== "package") {
+      result = result.filter((item) => !this.isPackageDisabled(item?._packageId));
+    }
+    return result;
+  }
+  /**
+   * Whether a package has been explicitly disabled. Unknown packages and
+   * items with no owning package are treated as enabled.
+   */
+  isPackageDisabled(packageId) {
+    if (!packageId) return false;
+    const pkg = this.getPackage(packageId);
+    return pkg?.enabled === false || pkg?.status === "disabled";
   }
   /**
    * Get all registered metadata types (Kinds)
@@ -539,12 +569,14 @@ var SchemaRegistry = class {
   // ==========================================
   installPackage(manifest, settings) {
     const now = (/* @__PURE__ */ new Date()).toISOString();
+    const disabled = this.initialDisabledPackageIds.has(manifest.id);
     const pkg = {
       manifest,
-      status: "installed",
-      enabled: true,
+      status: disabled ? "disabled" : "installed",
+      enabled: !disabled,
       installedAt: now,
       updatedAt: now,
+      ...disabled ? { statusChangedAt: now } : {},
       settings
     };
     if (manifest.namespace) {
@@ -830,6 +862,12 @@ var SysMetadataRepository = class {
         version,
         updated_at: now
       };
+      if (existing) {
+        const existingPkg = existing.package_id ?? null;
+        parentRowData.package_id = existingPkg ?? opts.packageId ?? null;
+      } else {
+        parentRowData.package_id = opts.packageId ?? null;
+      }
       if (existing) {
         const existingId = existing.id;
         if (existingId === void 0) {
@@ -2183,13 +2221,13 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
           state: "active",
           organization_id: oid
         };
-        if (packageId) whereClause._packageId = packageId;
+        if (packageId) whereClause.package_id = packageId;
         let rs = await this.engine.find("sys_metadata", { where: whereClause });
         if (!rs || rs.length === 0) {
           const alt = import_shared4.PLURAL_TO_SINGULAR[request.type] ?? import_shared4.SINGULAR_TO_PLURAL[request.type];
           if (alt) {
             const altWhere = { type: alt, state: "active", organization_id: oid };
-            if (packageId) altWhere._packageId = packageId;
+            if (packageId) altWhere.package_id = packageId;
             rs = await this.engine.find("sys_metadata", { where: altWhere });
           }
         }
@@ -2212,6 +2250,10 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
         for (const record of records) {
           const data = typeof record.metadata === "string" ? JSON.parse(record.metadata) : record.metadata;
           if (data && typeof data === "object" && "name" in data) {
+            const recPkg = record.package_id ?? void 0;
+            if (recPkg && data._packageId === void 0) {
+              data._packageId = recPkg;
+            }
             byName.set(data.name, data);
           }
           if (this.environmentId === void 0) {
@@ -2251,6 +2293,11 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
       }
     } catch {
     }
+    if (request.type !== "package" && request.type !== "object" && request.type !== "objects") {
+      items = items.filter(
+        (it) => !this.engine.registry.isPackageDisabled(it?._packageId)
+      );
+    }
     return {
       type: request.type,
       items: decorateMetadataItems(
@@ -2294,6 +2341,10 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
       const record = (orgId ? await findOverlay(orgId) : void 0) ?? await findOverlay(null);
       if (record) {
         item = typeof record.metadata === "string" ? JSON.parse(record.metadata) : record.metadata;
+        const recPkg = record.package_id ?? void 0;
+        if (recPkg && item && typeof item === "object" && item._packageId === void 0) {
+          item._packageId = recPkg;
+        }
       }
     } catch {
     }
@@ -3740,7 +3791,8 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
           actor: request.actor ?? "system",
           source: "protocol.saveMetaItem",
           intent,
-          state: mode === "draft" ? "draft" : "active"
+          state: mode === "draft" ? "draft" : "active",
+          ...request.packageId !== void 0 ? { packageId: request.packageId } : {}
         });
         if (mode === "publish") {
           this.applyObjectRegistryMutation(request);
@@ -3791,12 +3843,16 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
         where: scopedWhere
       });
       if (existing) {
-        await this.engine.update("sys_metadata", {
+        const updateRow = {
           metadata: JSON.stringify(request.item),
           updated_at: now,
           version: (existing.version || 0) + 1,
           state: "active"
-        }, {
+        };
+        const existingPkg = existing.package_id ?? null;
+        const nextPkg = existingPkg ?? request.packageId ?? null;
+        if (nextPkg !== null) updateRow.package_id = nextPkg;
+        await this.engine.update("sys_metadata", updateRow, {
           where: { id: existing.id }
         });
       } else {
@@ -3816,6 +3872,7 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
           updated_at: now,
           organization_id: orgId
         };
+        if (request.packageId) row.package_id = request.packageId;
         await this.engine.insert("sys_metadata", row);
       }
       return {
@@ -5793,6 +5850,8 @@ var _ObjectQL = class _ObjectQL {
       "policies",
       // AI Protocol
       "agents",
+      "tools",
+      "skills",
       "ragPipelines",
       // API Protocol
       "apis",