@useatlas/types - npm Package Compare versions

Comparing version 0.0.28 to 0.1.0

dist/approval.d.ts

@@ -94,3 +94,11 @@ /**
     explanation: string | null;
-    connectionId: string;
+    /**
+     * Group scope for this approval (#2344). NULL for legacy pre-#2344
+     * rows and for callers that don't have a group context yet; new
+     * rows resolve via the connection's `group_id`. One approval covers
+     * every member of the group running the same query — keying on
+     * connection forced re-approval per replica even when an admin had
+     * already greenlit the query for the group.
+     */
+    connectionGroupId: string | null;
     tablesAccessed: string[];
@@ -97,0 +105,0 @@ columnsAccessed: string[];

dist/compliance.d.ts

@@ -36,4 +36,11 @@ /**
     columnName: string;
-    /** Connection ID for the datasource. */
-    connectionId: string;
+    /**
+     * Group scope (#2341). One classification row per (org, table, column,
+     * group) — multi-member groups share the same row (replicas inside a
+     * group share schema, so the column's PII category is the same across
+     * all members). Nullable for legacy rows whose original connection no
+     * longer resolves to a live group; those classifications apply
+     * globally within the org (the COALESCE sentinel bucket).
+     */
+    connectionGroupId: string | null;
     /** Detected or manually assigned PII category. */
@@ -40,0 +47,0 @@ category: PIICategory;

dist/conversation.d.ts

@@ -9,3 +9,17 @@ /** Conversation persistence types — wire format for conversations and messages. */
     surface: Surface;
+    /**
+     * Execution target — the specific connection (replica) SQL runs
+     * against. May be overridden per-turn by the chat header without
+     * persisting back to this column.
+     */
     connectionId: string | null;
+    /**
+     * Content scope — the connection group whose semantic entities,
+     * dashboards, and approvals resolve for this conversation. Independent
+     * of `connectionId`: a multi-member "prod" group can resolve content
+     * while `connectionId` points at a single member. Nullable for legacy
+     * conversations created before the multi-environment slice (#2345);
+     * runtime falls back to single-connection behavior in that case.
+     */
+    connectionGroupId: string | null;
     starred: boolean;
@@ -12,0 +26,0 @@ createdAt: string;

dist/dashboard.d.ts

@@ -42,3 +42,8 @@ import type { ShareMode } from "./share";
     cachedAt: string | null;
-    connectionId: string | null;
+    /**
+     * Group-scoped execution target (1.4.4). Resolves to a physical
+     * connection at view time via the group's primary member, or the
+     * first member by `(created_at, id)` when no primary is set.
+     */
+    connectionGroupId: string | null;
     layout: DashboardCardLayout | null;
@@ -45,0 +50,0 @@ createdAt: string;

dist/migration.d.ts

@@ -49,20 +49,9 @@ /** Migration bundle types — wire format for atlas export/import. */
     /**
-     * Legacy connection scope. Retained for compatibility with bundles
-     * exported before #2340; new exports also populate
-     * `connectionGroupId` (additive). Removed alongside the column
-     * itself in a follow-on slice — see PRD #2336 §"Migration sequencing".
-     *
-     * @deprecated Prefer `connectionGroupId` when reading bundles from
-     *   1.4.4+ instances.
-     */
-    connectionId: string | null;
-    /**
      * Group scope (multi-environment semantic layer, #2340). One entity
      * row per group — multi-member groups share the same definition.
-     * Optional during the wire-format transition: bundles exported by
-     * pre-1.4.4 instances omit the field. Consumers should resolve
-     * `connectionGroupId ?? null` and fall back to `connectionId` for
-     * legacy bundles.
+     * Nullable for global / unscoped entities and for bundles exported
+     * by pre-1.4.4 instances whose legacy `connectionId` no longer
+     * resolves to a live group.
      */
-    connectionGroupId?: string | null;
+    connectionGroupId: string | null;
 }
@@ -69,0 +58,0 @@ /** Exported learned pattern. */

dist/scheduled-task.d.ts

@@ -39,3 +39,7 @@ import type { ActionApprovalMode } from "./action";
     recipients: Recipient[];
-    connectionId: string | null;
+    /**
+     * Environment/group scope for this task. Resolves to a physical
+     * connection at run time via the group's primary member.
+     */
+    connectionGroupId: string | null;
     approvalMode: ActionApprovalMode;
@@ -42,0 +46,0 @@ enabled: boolean;

package.json

 {
   "name": "@useatlas/types",
-  "version": "0.0.28",
+  "version": "0.1.0",
   "description": "Shared types for the Atlas text-to-SQL agent",
@@ -5,0 +5,0 @@ "type": "module",

No alert changes

Improved metrics

Total package byte prevSize

184372

0.78%

Lines of code

4703

0.58%

No dependency changes