@granular-software/sdk 0.4.13 → 0.4.14

package/dist/index.mjs

@@ -5591,6 +5591,19 @@ function normalizeUser(user) {
     permissions: Array.isArray(user.permissions) ? user.permissions : []
   };
 }
+function normalizeEnvironmentData(environment) {
+  const buildPolicy = environment.buildPolicy || environment.tracking || (environment.tagId ? { mode: "tag", tagId: environment.tagId } : { mode: "pinned", versionId: environment.versionId || environment.buildId });
+  const environmentName = environment.environment || environment.envName || "prod";
+  return {
+    ...environment,
+    ontologyId: environment.ontologyId || environment.sandboxId,
+    versionId: environment.versionId || environment.buildId,
+    envName: environmentName,
+    environment: environmentName,
+    buildPolicy,
+    tracking: environment.tracking || buildPolicy
+  };
+}
 var Environment = class extends Session {
   envData;
   _apiKey;
@@ -5609,10 +5622,26 @@ var Environment = class extends Session {
   get sandboxId() {
     return this.envData.sandboxId;
   }
+  /** The ontology ID */
+  get ontologyId() {
+    return this.envData.ontologyId || this.envData.sandboxId;
+  }
   /** The subject ID */
   get subjectId() {
     return this.envData.subjectId;
   }
+  /** The named environment slot, such as dev or prod */
+  get envName() {
+    return this.envData.envName;
+  }
+  /** The named environment slot, such as dev or prod */
+  get environment() {
+    return this.envData.environment || this.envData.envName;
+  }
+  /** The resolved ontology version backing this environment */
+  get versionId() {
+    return this.envData.versionId || this.envData.buildId;
+  }
   /** Internal Granular user identifier for this environment */
   get granularId() {
     return this.envData.subjectId;
@@ -6584,7 +6613,7 @@ var Granular = class {
     throw new Error("connect() requires either userId, granularId, or a user object returned by recordUser().");
   }
   /**
-   * Connect to a sandbox and establish a real-time environment session.
+   * Connect to an ontology environment and establish a real-time session.
    * 
    * Effects are registered at the sandbox level via `granular.registerEffect()`
    * or `granular.registerEffects()`. Sessions pick up live availability from
@@ -6596,7 +6625,8 @@ var Granular = class {
    * @example
    * ```typescript
    * const environment = await granular.connect({
-   *   sandbox: 'my-sandbox',
+   *   ontology: 'my-ontology',
+   *   environment: 'dev',
    *   userId: 'user_123',
    *   permissions: ['agent'],
    * });
@@ -6616,17 +6646,28 @@ var Granular = class {
    * 
    * console.log(await job.result); // 'Hello!'
    * ```
-   */
+  */
   async connect(options) {
     const clientId = options.clientId || `client_${Date.now()}`;
+    const ontology = options.ontology;
+    if (!ontology) {
+      throw new Error("connect() requires `ontology`.");
+    }
+    const environmentName = options.environment;
+    if (!environmentName) {
+      throw new Error("connect() requires `environment`.");
+    }
+    const tagName = options.tagName?.trim() || void 0;
     const user = await this.resolveConnectUser(options);
-    const sandbox = await this.findOrCreateSandbox(options.sandbox);
+    const sandbox = await this.findOrCreateSandbox(ontology);
     for (const profileName of user.permissions) {
       const profileId = await this.ensurePermissionProfile(sandbox.sandboxId, profileName);
       await this.ensureAssignment(user.granularId, sandbox.sandboxId, profileId);
     }
     const envData = await this.environments.create(sandbox.sandboxId, {
       subjectId: user.granularId,
+      environment: environmentName,
+      tagName,
       permissionProfileId: null
     });
     await this.activateEnvironment(envData.environmentId);
@@ -7061,16 +7102,22 @@ var Granular = class {
         const result = await this.request(
           `/control/sandboxes/${sandboxId}/environments`
         );
-        return result.items;
+        return result.items.map(normalizeEnvironmentData);
       },
       get: async (environmentId) => {
-        return this.request(`/control/environments/${environmentId}`);
+        return normalizeEnvironmentData(
+          await this.request(`/control/environments/${environmentId}`)
+        );
       },
       create: async (sandboxId, data) => {
-        return this.request(`/control/sandboxes/${sandboxId}/environments`, {
+        const environmentName = data.environment || data.envName;
+        return normalizeEnvironmentData(await this.request(`/control/sandboxes/${sandboxId}/environments`, {
           method: "POST",
-          body: JSON.stringify(data)
-        });
+          body: JSON.stringify({
+            ...data,
+            envName: environmentName
+          })
+        }));
       },
       delete: async (environmentId) => {
         return this.request(`/control/environments/${environmentId}`, {