@objectstack/objectql 5.1.0 → 6.0.0

package/dist/index.mjs

@@ -1191,7 +1191,7 @@ var SERVICE_CONFIG = {
   search: { route: "/api/v1/search", plugin: "plugin-search" }
 };
 var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementation {
-  constructor(engine, getServicesRegistry, getFeedService, projectId) {
+  constructor(engine, getServicesRegistry, getFeedService, environmentId) {
     /**
      * Lazily-instantiated SysMetadataRepository per organization. Keyed by
      * `${organizationId ?? '__env__'}`. Repositories are stateful — they
@@ -1202,7 +1202,7 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
     /**
      * One-time guard for ensuring the overlay-uniqueness UNIQUE INDEX exists
      * on `sys_metadata`. ADR-0005: scopes overlays by
-     * `(type, name, organization_id, project_id, scope)` for active rows only.
+     * `(type, name, organization_id, environment_id, scope)` for active rows only.
      * Idempotent SQL — safe to attempt on every protocol instance.
      *
      * Inlined here (rather than importing from @objectstack/metadata/migrations)
@@ -1212,7 +1212,7 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
     this.engine = engine;
     this.getServicesRegistry = getServicesRegistry;
     this.getFeedService = getFeedService;
-    this.projectId = projectId;
+    this.environmentId = environmentId;
   }
   /**
    * Lazily obtain a SysMetadataRepository for the given organization.
@@ -1280,10 +1280,10 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
    * Exposes the project scope the protocol is bound to. Consumers like
    * the HTTP dispatcher use this to decide whether to trust the process-
    * wide SchemaRegistry or whether they must route a read through the
-   * protocol's project_id-filtered lookup.
+   * protocol's environment_id-filtered lookup.
    */
   getProjectId() {
-    return this.projectId;
+    return this.environmentId;
   }
   requireFeedService() {
     const svc = this.getFeedService?.();
@@ -1396,7 +1396,7 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
   async getMetaItems(request) {
     const { packageId } = request;
     let items = [];
-    if (this.projectId === void 0) {
+    if (this.environmentId === void 0) {
       items = [...this.engine.registry.listItems(request.type, packageId)];
       if (items.length === 0) {
         const alt = PLURAL_TO_SINGULAR[request.type] ?? SINGULAR_TO_PLURAL[request.type];
@@ -1448,7 +1448,7 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
           if (data && typeof data === "object" && "name" in data) {
             byName.set(data.name, data);
           }
-          if (this.projectId === void 0) {
+          if (this.environmentId === void 0) {
             this.engine.registry.registerItem(request.type, data, "name");
           }
         }
@@ -2456,7 +2456,7 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
     if (!request.item) {
       throw new Error("Item data is required");
     }
-    if (this.projectId !== void 0 && !_ObjectStackProtocolImplementation.isOverlayAllowed(request.type)) {
+    if (this.environmentId !== void 0 && !_ObjectStackProtocolImplementation.isOverlayAllowed(request.type)) {
       const allowed = Array.from(_ObjectStackProtocolImplementation.OVERLAY_ALLOWED_TYPES).join(", ");
       const err = new Error(
         `[not_overridable] Metadata type '${request.type}' has not opted into per-org overlay writes. Set allowOrgOverride: true on its DEFAULT_METADATA_TYPE_REGISTRY entry to enable. Currently allowed: ${allowed}. See docs/adr/0005-metadata-customization-overlay.md.`
@@ -2623,7 +2623,7 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
    * with {@link saveMetaItem}.
    */
   async deleteMetaItem(request) {
-    if (this.projectId !== void 0 && !_ObjectStackProtocolImplementation.isOverlayAllowed(request.type)) {
+    if (this.environmentId !== void 0 && !_ObjectStackProtocolImplementation.isOverlayAllowed(request.type)) {
       const err = new Error(
         `[not_overridable] Metadata type '${request.type}' has not opted into per-org overlay writes. See docs/adr/0005-metadata-customization-overlay.md.`
       );
@@ -2656,7 +2656,7 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
           actor: request.actor ?? "system",
           source: "protocol.deleteMetaItem"
         });
-        if (this.projectId === void 0) {
+        if (this.environmentId === void 0) {
           try {
             const services = this.getServicesRegistry?.();
             const metadataService = services?.get("metadata");
@@ -2706,7 +2706,7 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
         };
       }
       await this.engine.delete("sys_metadata", { where: { id: existing.id } });
-      if (this.projectId === void 0) {
+      if (this.environmentId === void 0) {
         try {
           const services = this.getServicesRegistry?.();
           const metadataService = services?.get("metadata");
@@ -2737,7 +2737,7 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
    *
    * Per ADR-0005, project-kernel mode ALSO hydrates from sys_metadata —
    * customization overlay rows must survive restart. Scope filter
-   * (`project_id = this.projectId ?? null`) keeps tenants isolated.
+   * (`environment_id = this.environmentId ?? null`) keeps tenants isolated.
    */
   async loadMetaFromDb() {
     let loaded = 0;
@@ -3709,7 +3709,7 @@ var _ObjectQL = class _ObjectQL {
     // Per-engine SchemaRegistry instance.
     //
     // Historically SchemaRegistry was a process-wide singleton of static state,
-    // which broke multi-project servers: a project kernel would inherit every
+    // which broke multi-environment servers: a project kernel would inherit every
     // object registered by the control plane (e.g. sys_metadata), and
     // getDriver()'s owner lookup would route CRUD to the wrong database. Each
     // engine now owns its registry so kernels are fully isolated.
@@ -3740,7 +3740,7 @@ var _ObjectQL = class _ObjectQL {
    * Expose the SchemaRegistry for plugins to register metadata.
    *
    * Returns the per-engine instance, NOT the class. Each ObjectQL engine
-   * owns its registry so multi-project kernels remain isolated.
+   * owns its registry so multi-environment kernels remain isolated.
    */
   get registry() {
     return this._registry;
@@ -5526,7 +5526,7 @@ var ObjectQLPlugin = class {
         this.ql,
         () => ctx.getServices ? ctx.getServices() : /* @__PURE__ */ new Map(),
         void 0,
-        this.projectId
+        this.environmentId
       );
       ctx.registerService("protocol", protocolShim);
       ctx.logger.info("Protocol service registered");
@@ -5588,7 +5588,7 @@ var ObjectQLPlugin = class {
       } else {
         await this.syncRegisteredSchemas(ctx);
       }
-      if (this.projectId === void 0) {
+      if (this.environmentId === void 0) {
         await this.restoreMetadataFromDb(ctx);
       } else {
         ctx.logger.info("Project kernel \u2014 skipping sys_metadata hydration (metadata sourced from artifact)");
@@ -5596,7 +5596,7 @@ var ObjectQLPlugin = class {
       if (!this.skipSchemaSync) {
         await this.syncRegisteredSchemas(ctx);
       }
-      if (this.projectId === void 0) {
+      if (this.environmentId === void 0) {
         await this.bridgeObjectsToMetadataService(ctx);
       }
       this.registerAuditHooks(ctx);
@@ -5625,7 +5625,7 @@ var ObjectQLPlugin = class {
       this.ql = opts.ql;
     }
     this.hostContext = opts.hostContext ?? hostContext;
-    this.projectId = opts.projectId;
+    this.environmentId = opts.environmentId;
     if (typeof opts.startupTimeout === "number" && opts.startupTimeout > 0) {
       this.startupTimeout = opts.startupTimeout;
     }