@objectstack/client 5.2.0 → 6.0.0

package/dist/index.mjs

@@ -655,12 +655,12 @@ var ObjectStackClient = class {
      * through this API.
      *
      * Endpoints:
-     * - GET    /api/v1/cloud/projects            → list environments
-     * - GET    /api/v1/cloud/projects/:id        → get one (with database info)
-     * - POST   /api/v1/cloud/projects            → provision a new project
-     * - PATCH  /api/v1/cloud/projects/:id        → update (displayName, plan, status, …)
-     * - POST   /api/v1/cloud/projects/:id/activate → set as session's active project
-     * - POST   /api/v1/cloud/projects/:id/credentials/rotate → rotate credential
+     * - GET    /api/v1/cloud/environments            → list environments
+     * - GET    /api/v1/cloud/environments/:id        → get one (with database info)
+     * - POST   /api/v1/cloud/environments            → provision a new project
+     * - PATCH  /api/v1/cloud/environments/:id        → update (displayName, plan, status, …)
+     * - POST   /api/v1/cloud/environments/:id/activate → set as session's active project
+     * - POST   /api/v1/cloud/environments/:id/credentials/rotate → rotate credential
      *
      * @see docs/adr/0002-project-database-isolation.md
      */
@@ -675,7 +675,7 @@ var ObjectStackClient = class {
         if (filters?.env_type) params.set("envType", filters.env_type);
         if (filters?.status) params.set("status", filters.status);
         const qs = params.toString();
-        const url = `${this.baseUrl}/api/v1/cloud/projects${qs ? "?" + qs : ""}`;
+        const url = `${this.baseUrl}/api/v1/cloud/environments${qs ? "?" + qs : ""}`;
         const res = await this.fetch(url);
         return this.unwrapResponse(res);
       },
@@ -683,7 +683,7 @@ var ObjectStackClient = class {
        * Get a single project (joined with its database and membership row).
        */
       get: async (id) => {
-        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}`);
+        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(id)}`);
         return this.unwrapResponse(res);
       },
       /**
@@ -691,7 +691,7 @@ var ObjectStackClient = class {
        * `ProjectProvisioningService.provisionProject` on the server.
        */
       create: async (req) => {
-        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects`, {
+        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/environments`, {
           method: "POST",
           body: JSON.stringify(req)
         });
@@ -701,7 +701,7 @@ var ObjectStackClient = class {
        * Update a project (display_name, plan, status, is_default, metadata).
        */
       update: async (id, patch) => {
-        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}`, {
+        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(id)}`, {
           method: "PATCH",
           body: JSON.stringify(patch)
         });
@@ -710,12 +710,12 @@ var ObjectStackClient = class {
       /**
        * Cascade-delete a project: cleans up credential/member/package_installation
        * rows, releases the physical database via the provisioning adapter, and
-       * removes the `sys_project` row. Default projects require `force: true`.
+       * removes the `sys_environment` row. Default projects require `force: true`.
        */
       delete: async (id, opts) => {
         const qs = opts?.force ? "?force=1" : "";
         const res = await this.fetch(
-          `${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}${qs}`,
+          `${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(id)}${qs}`,
           { method: "DELETE" }
         );
         return this.unwrapResponse(res);
@@ -726,7 +726,7 @@ var ObjectStackClient = class {
        * are routed to this project's database.
        */
       activate: async (id) => {
-        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/activate`, {
+        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(id)}/activate`, {
           method: "POST"
         });
         return this.unwrapResponse(res);
@@ -735,7 +735,7 @@ var ObjectStackClient = class {
        * Rotate the active database credential for this project.
        */
       rotateCredential: async (id, plaintext) => {
-        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/credentials/rotate`, {
+        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(id)}/credentials/rotate`, {
           method: "POST",
           body: JSON.stringify({ plaintext })
         });
@@ -746,7 +746,7 @@ var ObjectStackClient = class {
        * uniqueness server-side; invalidates the dispatcher's routing cache.
        */
       updateHostname: async (id, hostname) => {
-        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/hostname`, {
+        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(id)}/hostname`, {
           method: "POST",
           body: JSON.stringify({ hostname })
         });
@@ -760,7 +760,7 @@ var ObjectStackClient = class {
        * freely exposes all revisions.
        */
       updateVisibility: async (id, visibility) => {
-        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}`, {
+        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(id)}`, {
           method: "PATCH",
           body: JSON.stringify({ visibility })
         });
@@ -779,7 +779,7 @@ var ObjectStackClient = class {
         if (opts?.branch) params.set("branch", opts.branch);
         const qs = params.toString();
         const res = await this.fetch(
-          `${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/revisions${qs ? `?${qs}` : ""}`
+          `${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(id)}/revisions${qs ? `?${qs}` : ""}`
         );
         return this.unwrapResponse(res);
       },
@@ -790,7 +790,7 @@ var ObjectStackClient = class {
        */
       listBranches: async (id) => {
         const res = await this.fetch(
-          `${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/branches`
+          `${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(id)}/branches`
         );
         return this.unwrapResponse(res);
       },
@@ -800,7 +800,7 @@ var ObjectStackClient = class {
        */
       renameBranch: async (id, from, to) => {
         const res = await this.fetch(
-          `${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/branches/${encodeURIComponent(from)}/rename`,
+          `${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(id)}/branches/${encodeURIComponent(from)}/rename`,
           {
             method: "POST",
             headers: { "content-type": "application/json" },
@@ -817,7 +817,7 @@ var ObjectStackClient = class {
        */
       deleteBranch: async (id, name) => {
         const res = await this.fetch(
-          `${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/branches/${encodeURIComponent(name)}`,
+          `${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(id)}/branches/${encodeURIComponent(name)}`,
           { method: "DELETE" }
         );
         return this.unwrapResponse(res);
@@ -828,7 +828,7 @@ var ObjectStackClient = class {
        */
       activateRevision: async (id, commitId) => {
         const res = await this.fetch(
-          `${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/revisions/${encodeURIComponent(commitId)}/activate`,
+          `${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(id)}/revisions/${encodeURIComponent(commitId)}/activate`,
           { method: "POST" }
         );
         return this.unwrapResponse(res);
@@ -840,7 +840,7 @@ var ObjectStackClient = class {
        * `failed` with `metadata.provisioningError` updated.
        */
       retryProvisioning: async (id) => {
-        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/retry`, {
+        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(id)}/retry`, {
           method: "POST"
         });
         return this.unwrapResponse(res);
@@ -849,7 +849,7 @@ var ObjectStackClient = class {
        * List members of a project (per-project RBAC).
        */
       listMembers: async (id) => {
-        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/members`);
+        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(id)}/members`);
         return this.unwrapResponse(res);
       },
       /**
@@ -859,7 +859,7 @@ var ObjectStackClient = class {
        * row already existed; the call is idempotent.
        */
       addMember: async (id, payload) => {
-        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/members`, {
+        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(id)}/members`, {
           method: "POST",
           headers: { "content-type": "application/json" },
           body: JSON.stringify(payload)
@@ -872,7 +872,7 @@ var ObjectStackClient = class {
        */
       updateMemberRole: async (id, memberId, role) => {
         const res = await this.fetch(
-          `${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/members/${encodeURIComponent(memberId)}`,
+          `${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(id)}/members/${encodeURIComponent(memberId)}`,
           {
             method: "PATCH",
             headers: { "content-type": "application/json" },
@@ -887,7 +887,7 @@ var ObjectStackClient = class {
        */
       removeMember: async (id, memberId) => {
         const res = await this.fetch(
-          `${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/members/${encodeURIComponent(memberId)}`,
+          `${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(id)}/members/${encodeURIComponent(memberId)}`,
           { method: "DELETE" }
         );
         return this.unwrapResponse(res);
@@ -917,12 +917,12 @@ var ObjectStackClient = class {
       packages: {
         /** List all packages installed in a specific project. */
         list: async (envId) => {
-          const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(envId)}/packages`);
+          const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(envId)}/packages`);
           return this.unwrapResponse(res);
         },
         /** Install a package into the project. */
         install: async (envId, body) => {
-          const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(envId)}/packages`, {
+          const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(envId)}/packages`, {
             method: "POST",
             body: JSON.stringify(body)
           });
@@ -930,33 +930,33 @@ var ObjectStackClient = class {
         },
         /** Get a single installation record. */
         get: async (envId, pkgId) => {
-          const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(envId)}/packages/${encodeURIComponent(pkgId)}`);
+          const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(envId)}/packages/${encodeURIComponent(pkgId)}`);
           return this.unwrapResponse(res);
         },
         /** Enable a previously disabled package. */
         enable: async (envId, pkgId) => {
-          const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(envId)}/packages/${encodeURIComponent(pkgId)}/enable`, {
+          const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(envId)}/packages/${encodeURIComponent(pkgId)}/enable`, {
             method: "PATCH"
           });
           return this.unwrapResponse(res);
         },
         /** Disable an installed package (metadata will not be loaded). */
         disable: async (envId, pkgId) => {
-          const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(envId)}/packages/${encodeURIComponent(pkgId)}/disable`, {
+          const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(envId)}/packages/${encodeURIComponent(pkgId)}/disable`, {
             method: "PATCH"
           });
           return this.unwrapResponse(res);
         },
         /** Uninstall a package from the project. Forbidden for scope=platform packages. */
         uninstall: async (envId, pkgId) => {
-          const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(envId)}/packages/${encodeURIComponent(pkgId)}`, {
+          const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(envId)}/packages/${encodeURIComponent(pkgId)}`, {
             method: "DELETE"
           });
           return this.unwrapResponse(res);
         },
         /** Upgrade an installed package to a newer version. */
         upgrade: async (envId, pkgId, targetVersion) => {
-          const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(envId)}/packages/${encodeURIComponent(pkgId)}/upgrade`, {
+          const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/environments/${encodeURIComponent(envId)}/packages/${encodeURIComponent(pkgId)}/upgrade`, {
             method: "POST",
             body: JSON.stringify({ targetVersion })
           });
@@ -2706,7 +2706,7 @@ var ObjectStackClient = class {
     };
     this.baseUrl = config.baseUrl.replace(/\/$/, "");
     this.token = config.token;
-    this.projectId = config.projectId;
+    this.environmentId = config.environmentId;
     this.fetchImpl = config.fetch || globalThis.fetch.bind(globalThis);
     this.logger = config.logger || createLogger({
       level: config.debug ? "debug" : "info",
@@ -2787,12 +2787,12 @@ var ObjectStackClient = class {
    * Project-scoped client factory.
    *
    * Returns a thin wrapper around the data / meta / packages namespaces that
-   * prefixes every request with `/api/v1/projects/:projectId/...`. Use this
+   * prefixes every request with `/api/v1/environments/:environmentId/...`. Use this
    * when the server has `enableProjectScoping: true` in its REST API config.
    *
    * Backward compatibility: `client.data.*`, `client.meta.*`, and
    * `client.packages.*` continue to work unchanged; they hit unscoped routes
-   * and rely on hostname / `X-Project-Id` header / session resolution.
+   * and rely on hostname / `X-Environment-Id` header / session resolution.
    *
    * @example
    * ```ts
@@ -2801,11 +2801,11 @@ var ObjectStackClient = class {
    * const objects = await scoped.meta.getItems('object');
    * ```
    */
-  project(projectId) {
-    if (!projectId) {
-      throw new Error("[ObjectStack] project(id): projectId is required");
+  project(environmentId) {
+    if (!environmentId) {
+      throw new Error("[ObjectStack] project(id): environmentId is required");
     }
-    return new ScopedProjectClient(this, projectId);
+    return new ScopedProjectClient(this, environmentId);
   }
   // ── Internal accessors exposed to ScopedProjectClient ────────────────
   // The scoped client lives in the same module so using module-level access
@@ -2831,15 +2831,15 @@ var ObjectStackClient = class {
    * Update the active project id used for subsequent requests.
    * Pass `undefined` to clear (falls back to the session default).
    */
-  setProjectId(projectId) {
-    this.projectId = projectId;
-    this.logger.debug("Active project changed", { projectId });
+  setProjectId(environmentId) {
+    this.environmentId = environmentId;
+    this.logger.debug("Active project changed", { environmentId });
   }
   /**
    * Current active project id (if set).
    */
   getProjectId() {
-    return this.projectId;
+    return this.environmentId;
   }
   /**
    * Event Subscription API
@@ -2881,8 +2881,8 @@ var ObjectStackClient = class {
     if (this.token) {
       headers["Authorization"] = `Bearer ${this.token}`;
     }
-    if (this.projectId) {
-      headers["X-Project-Id"] = this.projectId;
+    if (this.environmentId) {
+      headers["X-Environment-Id"] = this.environmentId;
     }
     const res = await this.fetchImpl(url, { ...options, headers });
     this.logger.debug("HTTP response", {
@@ -2951,7 +2951,7 @@ var ObjectStackClient = class {
   }
 };
 var ScopedProjectClient = class {
-  constructor(parent, projectId) {
+  constructor(parent, environmentId) {
     /**
      * Metadata operations scoped to this project.
      */
@@ -3139,7 +3139,7 @@ var ScopedProjectClient = class {
      * Automation (Flow) operations scoped to this project.
      *
      * Thin wrapper around the dispatcher's automation routes, mounted under
-     * `/api/v1/projects/:projectId/automation/...`. Surface mirrors the methods
+     * `/api/v1/environments/:environmentId/automation/...`. Surface mirrors the methods
      * needed by Studio's Flow viewer: read flow definition, execute (trigger),
      * list runs, fetch a single run.
      */
@@ -3180,15 +3180,15 @@ var ScopedProjectClient = class {
       }
     };
     this.parent = parent;
-    this.projectId = projectId;
+    this.environmentId = environmentId;
   }
-  /** The projectId this client is scoped to. */
+  /** The environmentId this client is scoped to. */
   getProjectId() {
-    return this.projectId;
+    return this.environmentId;
   }
   /** Prefix segment inserted between the baseUrl and the resource path. */
   scope() {
-    return `/api/v1/projects/${encodeURIComponent(this.projectId)}`;
+    return `/api/v1/environments/${encodeURIComponent(this.environmentId)}`;
   }
   url(suffix) {
     return `${this.parent._baseUrl()}${this.scope()}${suffix}`;