@useatlas/types 0.0.1 → 0.0.2

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/auth.ts
 var AUTH_MODES = ["none", "simple-key", "managed", "byot"];
-var ATLAS_ROLES = ["viewer", "analyst", "admin"];
+var ATLAS_ROLES = ["member", "admin", "owner", "platform_admin"];
 // src/connection.ts
 var DB_TYPES = [
   { value: "postgres", label: "PostgreSQL" },
@@ -24,12 +24,43 @@ var ALL_STATUSES = [
   "timed_out"
 ];
 var RESOLVED_STATUSES = new Set(ALL_STATUSES.filter((s) => s !== "pending_approval"));
+var ACTION_STATUSES = [
+  "pending",
+  "approved",
+  "denied",
+  "executed",
+  "failed",
+  "timed_out",
+  "auto_approved",
+  "rolled_back"
+];
 var VALID_STATUSES = new Set(ALL_STATUSES);
 function isActionToolResult(result) {
   if (result == null || typeof result !== "object")
     return false;
   const r = result;
-  return typeof r.actionId === "string" && typeof r.status === "string" && VALID_STATUSES.has(r.status);
+  if (typeof r.actionId !== "string" || r.actionId.length === 0)
+    return false;
+  if (typeof r.status !== "string")
+    return false;
+  if (!VALID_STATUSES.has(r.status))
+    return false;
+  switch (r.status) {
+    case "pending_approval":
+      return typeof r.summary === "string";
+    case "approved":
+    case "executed":
+    case "auto_approved":
+      return "result" in r;
+    case "failed":
+      return typeof r.error === "string";
+    case "denied":
+    case "rolled_back":
+    case "timed_out":
+      return true;
+    default:
+      return false;
+  }
 }
 
 // src/scheduled-task.ts
@@ -55,6 +86,7 @@ function isRecipient(value) {
 // src/errors.ts
 var CHAT_ERROR_CODES = [
   "auth_error",
+  "session_expired",
   "rate_limited",
   "configuration_error",
   "no_datasource",
@@ -65,8 +97,118 @@ var CHAT_ERROR_CODES = [
   "provider_timeout",
   "provider_unreachable",
   "provider_error",
-  "internal_error"
+  "internal_error",
+  "validation_error",
+  "not_found",
+  "forbidden",
+  "forbidden_role",
+  "org_not_found",
+  "plan_limit_exceeded",
+  "trial_expired",
+  "billing_check_failed",
+  "workspace_check_failed",
+  "workspace_suspended",
+  "workspace_throttled",
+  "workspace_deleted"
 ];
+function isChatErrorCode(value) {
+  return CHAT_ERROR_CODES.includes(value);
+}
+var RETRYABLE_MAP = {
+  rate_limited: true,
+  provider_timeout: true,
+  provider_unreachable: true,
+  provider_error: true,
+  provider_rate_limit: true,
+  internal_error: true,
+  auth_error: false,
+  session_expired: false,
+  configuration_error: false,
+  no_datasource: false,
+  invalid_request: false,
+  provider_model_not_found: false,
+  provider_auth_error: false,
+  validation_error: false,
+  not_found: false,
+  forbidden: false,
+  forbidden_role: false,
+  org_not_found: false,
+  plan_limit_exceeded: false,
+  trial_expired: false,
+  billing_check_failed: true,
+  workspace_check_failed: true,
+  workspace_suspended: false,
+  workspace_throttled: true,
+  workspace_deleted: false
+};
+function isRetryableError(code) {
+  return RETRYABLE_MAP[code];
+}
+var CLIENT_ERROR_CODES = [
+  "api_unreachable",
+  "auth_failure",
+  "rate_limited_http",
+  "server_error",
+  "offline"
+];
+function extractHostFromError(msg) {
+  const refusedMatch = msg.match(/ECONNREFUSED\s+(\S+)/i);
+  if (refusedMatch)
+    return refusedMatch[1];
+  const notFoundMatch = msg.match(/ENOTFOUND\s+(\S+)/i);
+  if (notFoundMatch)
+    return notFoundMatch[1];
+  return "(unknown host)";
+}
+function matchError(error, opts) {
+  const msg = error instanceof Error ? error.message : String(error);
+  if (/too many (clients already|connections)|connection pool exhausted|remaining connection slots are reserved/i.test(msg)) {
+    return {
+      code: "rate_limited",
+      message: "Database connection pool exhausted — try again in a few seconds, or reduce concurrent queries"
+    };
+  }
+  if (/ECONNREFUSED/i.test(msg)) {
+    const host = extractHostFromError(msg);
+    return {
+      code: "internal_error",
+      message: `Database unreachable at ${host} — check that the database is running and accessible`
+    };
+  }
+  if (/ENOTFOUND/i.test(msg)) {
+    const host = extractHostFromError(msg);
+    return {
+      code: "internal_error",
+      message: `Could not resolve hostname "${host}" — check your connection URL`
+    };
+  }
+  if (/SELF_SIGNED_CERT|UNABLE_TO_VERIFY_LEAF_SIGNATURE|ssl\s+connection|tls\s+handshake|certificate\s+(has expired|verify|error|rejected)/i.test(msg)) {
+    return {
+      code: "internal_error",
+      message: "SSL connection failed — check sslmode in your connection string"
+    };
+  }
+  if (/timeout|timed out|AbortError/i.test(msg)) {
+    const seconds = Math.max(1, opts?.timeoutSeconds ?? 30);
+    return {
+      code: "provider_timeout",
+      message: `Query exceeded the ${seconds}-second timeout — try a simpler query or increase ATLAS_QUERY_TIMEOUT`
+    };
+  }
+  if (/\b502\s+Bad Gateway\b|\b503\s+Service Unavailable\b/i.test(msg)) {
+    return {
+      code: "provider_unreachable",
+      message: "AI provider API unavailable — this is usually temporary, retry in a few seconds"
+    };
+  }
+  if (/fetch failed/i.test(msg)) {
+    return {
+      code: "provider_unreachable",
+      message: "Network request failed — the remote service may be down or unreachable"
+    };
+  }
+  return null;
+}
 function authErrorMessage(authMode) {
   switch (authMode) {
     case "simple-key":
@@ -83,65 +225,302 @@ function authErrorMessage(authMode) {
     }
   }
 }
+function classifyClientError(error) {
+  const msg = error.message;
+  if (msg.startsWith("{") || msg.startsWith("[")) {
+    return null;
+  }
+  if (typeof window !== "undefined" && typeof navigator !== "undefined" && navigator.onLine === false) {
+    return "offline";
+  }
+  if (error.name === "TypeError" || /fetch failed|failed to fetch|networkerror|network\s+request\s+failed|ECONNREFUSED|ENOTFOUND|ERR_CONNECTION_REFUSED/i.test(msg)) {
+    return "api_unreachable";
+  }
+  if (/\b401\b|Unauthorized/i.test(msg) && !/\bretry/i.test(msg)) {
+    return "auth_failure";
+  }
+  if (/\b429\b|Too Many Requests/i.test(msg)) {
+    return "rate_limited_http";
+  }
+  if (/\b50[0-9]\b|Internal Server Error|Bad Gateway|Service Unavailable/i.test(msg)) {
+    return "server_error";
+  }
+  return null;
+}
+function clientErrorInfo(clientCode, authMode) {
+  switch (clientCode) {
+    case "offline":
+      return {
+        title: "You appear to be offline.",
+        detail: "Reconnecting when your network is restored...",
+        clientCode,
+        retryable: true
+      };
+    case "api_unreachable":
+      return {
+        title: "Unable to connect to Atlas.",
+        detail: "Check your API URL configuration and ensure the server is running.",
+        clientCode,
+        retryable: true
+      };
+    case "auth_failure":
+      return {
+        title: authErrorMessage(authMode),
+        clientCode,
+        retryable: false
+      };
+    case "rate_limited_http":
+      return {
+        title: "Too many requests.",
+        detail: "Please try again in a moment.",
+        retryAfterSeconds: 30,
+        clientCode,
+        retryable: true
+      };
+    case "server_error":
+      return {
+        title: "Something went wrong on our end.",
+        detail: "Please try again.",
+        clientCode,
+        retryable: true
+      };
+    default: {
+      const _exhaustive = clientCode;
+      return { title: `Unknown error (${_exhaustive}).` };
+    }
+  }
+}
 function parseChatError(error, authMode) {
+  const clientCode = classifyClientError(error);
   let parsed;
   try {
     parsed = JSON.parse(error.message);
   } catch {
-    return { title: "Something went wrong. Please try again." };
+    if (clientCode) {
+      return clientErrorInfo(clientCode, authMode);
+    }
+    const raw = error.message.length > 200 ? error.message.slice(0, 200) + "..." : error.message;
+    return { title: "Something went wrong. Please try again.", detail: raw };
   }
-  const code = typeof parsed.error === "string" ? parsed.error : undefined;
+  const rawCode = typeof parsed.error === "string" ? parsed.error : undefined;
   const serverMessage = typeof parsed.message === "string" ? parsed.message : undefined;
-  switch (code) {
+  const requestId = typeof parsed.requestId === "string" ? parsed.requestId : undefined;
+  if (rawCode === undefined || !isChatErrorCode(rawCode)) {
+    return { title: serverMessage ?? "Something went wrong. Please try again.", requestId };
+  }
+  const retryable = isRetryableError(rawCode);
+  switch (rawCode) {
     case "auth_error":
-      return { title: authErrorMessage(authMode), code };
+      return { title: authErrorMessage(authMode), code: rawCode, retryable, requestId };
     case "rate_limited": {
       const raw = typeof parsed.retryAfterSeconds === "number" ? parsed.retryAfterSeconds : undefined;
       const clamped = raw !== undefined ? Math.max(0, Math.min(raw, 300)) : undefined;
       return {
         title: "Too many requests.",
-        detail: clamped !== undefined ? `Try again in ${clamped} seconds.` : "Please wait before trying again.",
+        detail: clamped !== undefined ? `Try again in ${clamped} seconds.` : serverMessage ?? "Please wait before trying again.",
         retryAfterSeconds: clamped,
-        code
+        code: rawCode,
+        retryable,
+        requestId
       };
     }
     case "configuration_error":
-      return { title: "Atlas is not fully configured.", detail: serverMessage, code };
+      return { title: "Atlas is not fully configured.", detail: serverMessage, code: rawCode, retryable, requestId };
     case "no_datasource":
-      return { title: "No data source configured.", detail: serverMessage, code };
+      return { title: "No data source configured.", detail: serverMessage, code: rawCode, retryable, requestId };
     case "invalid_request":
-      return { title: "Invalid request.", detail: serverMessage, code };
+      return { title: "Invalid request.", detail: serverMessage, code: rawCode, retryable, requestId };
     case "provider_model_not_found":
-      return { title: "The configured AI model was not found.", detail: serverMessage, code };
+      return { title: "The configured AI model was not found.", detail: serverMessage, code: rawCode, retryable, requestId };
     case "provider_auth_error":
-      return { title: "The AI provider could not authenticate.", detail: serverMessage, code };
+      return { title: "The AI provider could not authenticate.", detail: serverMessage, code: rawCode, retryable, requestId };
     case "provider_rate_limit":
-      return { title: "The AI provider is rate limiting requests.", detail: serverMessage, code };
+      return { title: "The AI provider is rate limiting requests.", detail: serverMessage, code: rawCode, retryable, requestId };
     case "provider_timeout":
-      return { title: "The AI provider timed out.", detail: serverMessage, code };
+      return { title: "The AI provider timed out.", detail: serverMessage, code: rawCode, retryable, requestId };
     case "provider_unreachable":
-      return { title: "Could not reach the AI provider.", detail: serverMessage, code };
+      return { title: "Could not reach the AI provider.", detail: serverMessage, code: rawCode, retryable, requestId };
     case "provider_error":
-      return { title: "The AI provider returned an error.", detail: serverMessage, code };
+      return { title: "The AI provider returned an error.", detail: serverMessage, code: rawCode, retryable, requestId };
     case "internal_error":
-      return { title: serverMessage ?? "An unexpected error occurred.", code };
-    default:
-      return { title: serverMessage ?? "Something went wrong. Please try again." };
+      return { title: serverMessage ?? "An unexpected error occurred.", code: rawCode, retryable, requestId };
+    case "validation_error":
+      return { title: "Validation error.", detail: serverMessage, code: rawCode, retryable, requestId };
+    case "not_found":
+      return { title: "Not found.", detail: serverMessage, code: rawCode, retryable, requestId };
+    case "forbidden":
+      return { title: "Access denied.", detail: serverMessage, code: rawCode, retryable, requestId };
+    case "session_expired":
+      return { title: "Your session has expired.", detail: serverMessage ?? "Please sign in again.", code: rawCode, retryable, requestId };
+    case "forbidden_role":
+      return { title: "Admin role required.", detail: serverMessage, code: rawCode, retryable, requestId };
+    case "org_not_found":
+      return { title: "No active organization.", detail: serverMessage ?? "Select an organization and try again.", code: rawCode, retryable, requestId };
+    case "plan_limit_exceeded":
+      return { title: "Plan limit exceeded.", detail: serverMessage ?? "Upgrade your plan or wait until the next billing period.", code: rawCode, retryable, requestId };
+    case "trial_expired":
+      return { title: "Trial expired.", detail: serverMessage ?? "Upgrade to a paid plan to continue using Atlas.", code: rawCode, retryable, requestId };
+    case "billing_check_failed":
+      return { title: "Billing check failed.", detail: serverMessage ?? "Unable to verify billing status. Please try again.", code: rawCode, retryable, requestId };
+    case "workspace_check_failed":
+      return { title: "Workspace check failed.", detail: serverMessage ?? "Unable to verify workspace status. Please try again.", code: rawCode, retryable, requestId };
+    case "workspace_suspended":
+      return { title: "Workspace suspended.", detail: serverMessage ?? "Contact your workspace administrator to reactivate it.", code: rawCode, retryable, requestId };
+    case "workspace_throttled":
+      return { title: "Workspace throttled.", detail: serverMessage ?? "Your workspace has been temporarily throttled due to unusual activity. Requests will be delayed.", code: rawCode, retryable, requestId };
+    case "workspace_deleted":
+      return { title: "Workspace deleted.", detail: serverMessage ?? "This workspace has been permanently deleted. Create a new workspace to continue.", code: rawCode, retryable, requestId };
+    default: {
+      const _exhaustive = rawCode;
+      return { title: serverMessage ?? `Something went wrong (${_exhaustive}).`, requestId };
+    }
   }
 }
+// src/share.ts
+var SHARE_MODES = ["public", "org"];
+var SHARE_EXPIRY_OPTIONS = {
+  "1h": 3600,
+  "24h": 86400,
+  "7d": 604800,
+  "30d": 2592000,
+  never: null
+};
+// src/compliance.ts
+var PII_CATEGORIES = [
+  "email",
+  "phone",
+  "ssn",
+  "credit_card",
+  "name",
+  "ip_address",
+  "date_of_birth",
+  "address",
+  "passport",
+  "driver_license",
+  "other"
+];
+var PII_CONFIDENCE_LEVELS = ["high", "medium", "low"];
+var MASKING_STRATEGIES = ["full", "partial", "hash", "redact"];
+var PII_DETECTION_METHODS = ["regex", "column_name", "type_heuristic"];
+var MASKING_ROLES = ["admin", "owner", "analyst", "viewer", "member"];
+var COMPLIANCE_REPORT_TYPES = ["data-access", "user-activity"];
+var COMPLIANCE_EXPORT_FORMATS = ["json", "csv"];
+// src/organization.ts
+var ORG_ROLES = [...ATLAS_ROLES].reverse();
+// src/learned-pattern.ts
+var LEARNED_PATTERN_STATUSES = ["pending", "approved", "rejected"];
+var LEARNED_PATTERN_SOURCES = ["agent", "atlas-learn"];
+// src/prompt.ts
+var PROMPT_INDUSTRIES = ["saas", "ecommerce", "cybersecurity"];
+// src/sso.ts
+var SSO_PROVIDER_TYPES = ["saml", "oidc"];
+// src/profiler.ts
+var OBJECT_TYPES = ["table", "view", "materialized_view"];
+var FK_SOURCES = ["constraint", "inferred"];
+var PARTITION_STRATEGIES = ["range", "list", "hash"];
+// src/model-config.ts
+var MODEL_CONFIG_PROVIDERS = ["anthropic", "openai", "azure-openai", "custom"];
+// src/approval.ts
+var APPROVAL_RULE_TYPES = ["table", "column", "cost"];
+var APPROVAL_STATUSES = ["pending", "approved", "denied", "expired"];
+// src/platform.ts
+var WORKSPACE_STATUSES = ["active", "suspended", "deleted"];
+var PLAN_TIERS = ["free", "trial", "team", "enterprise"];
+var NOISY_NEIGHBOR_METRICS = ["queries", "tokens", "storage"];
+// src/onboarding-email.ts
+var ONBOARDING_EMAIL_STEPS = [
+  "welcome",
+  "connect_database",
+  "first_query",
+  "invite_team",
+  "explore_features"
+];
+var ONBOARDING_MILESTONES = [
+  "signup_completed",
+  "database_connected",
+  "first_query_executed",
+  "team_member_invited",
+  "feature_explored"
+];
+// src/abuse.ts
+var ABUSE_LEVELS = ["none", "warning", "throttled", "suspended"];
+var ABUSE_TRIGGERS = [
+  "query_rate",
+  "error_rate",
+  "unique_tables",
+  "manual"
+];
+// src/sla.ts
+var SLA_ALERT_STATUSES = ["firing", "resolved", "acknowledged"];
+var SLA_ALERT_TYPES = ["latency_p99", "error_rate"];
+// src/backups.ts
+var BACKUP_STATUSES = ["in_progress", "completed", "failed", "verified"];
+// src/residency.ts
+var WELL_KNOWN_REGIONS = [
+  "us-east",
+  "us-west",
+  "eu-west",
+  "eu-central",
+  "ap-southeast",
+  "ap-northeast"
+];
+var MIGRATION_STATUSES = ["pending", "in_progress", "completed", "failed"];
+// src/domain.ts
+var DOMAIN_STATUSES = ["pending", "verified", "failed"];
+var CERTIFICATE_STATUSES = ["PENDING", "ISSUED", "FAILED"];
 export {
   parseChatError,
+  matchError,
+  isRetryableError,
   isRecipient,
+  isChatErrorCode,
   isActionToolResult,
+  classifyClientError,
   authErrorMessage,
+  WORKSPACE_STATUSES,
+  WELL_KNOWN_REGIONS,
+  SSO_PROVIDER_TYPES,
+  SLA_ALERT_TYPES,
+  SLA_ALERT_STATUSES,
+  SHARE_MODES,
+  SHARE_EXPIRY_OPTIONS,
   RUN_STATUSES,
   RESOLVED_STATUSES,
+  PROMPT_INDUSTRIES,
+  PLAN_TIERS,
+  PII_DETECTION_METHODS,
+  PII_CONFIDENCE_LEVELS,
+  PII_CATEGORIES,
+  PARTITION_STRATEGIES,
+  ORG_ROLES,
+  ONBOARDING_MILESTONES,
+  ONBOARDING_EMAIL_STEPS,
+  OBJECT_TYPES,
+  NOISY_NEIGHBOR_METRICS,
+  MODEL_CONFIG_PROVIDERS,
+  MIGRATION_STATUSES,
+  MASKING_STRATEGIES,
+  MASKING_ROLES,
+  LEARNED_PATTERN_STATUSES,
+  LEARNED_PATTERN_SOURCES,
+  FK_SOURCES,
+  DOMAIN_STATUSES,
   DELIVERY_STATUSES,
   DELIVERY_CHANNELS,
   DB_TYPES,
+  COMPLIANCE_REPORT_TYPES,
+  COMPLIANCE_EXPORT_FORMATS,
+  CLIENT_ERROR_CODES,
   CHAT_ERROR_CODES,
+  CERTIFICATE_STATUSES,
+  BACKUP_STATUSES,
   AUTH_MODES,
   ATLAS_ROLES,
+  APPROVAL_STATUSES,
+  APPROVAL_RULE_TYPES,
   ALL_STATUSES,
-  ACTION_APPROVAL_MODES
+  ACTION_STATUSES,
+  ACTION_APPROVAL_MODES,
+  ABUSE_TRIGGERS,
+  ABUSE_LEVELS
 };

package/dist/learned-pattern.d.ts

@@ -0,0 +1,27 @@
+/** Learned query pattern types — wire format for the learned_patterns table. */
+/** All valid learned pattern statuses. */
+export declare const LEARNED_PATTERN_STATUSES: readonly ["pending", "approved", "rejected"];
+/** Status lifecycle for learned query patterns. */
+export type LearnedPatternStatus = (typeof LEARNED_PATTERN_STATUSES)[number];
+/** All valid learned pattern sources. */
+export declare const LEARNED_PATTERN_SOURCES: readonly ["agent", "atlas-learn"];
+/** Who proposed the pattern. */
+export type LearnedPatternSource = (typeof LEARNED_PATTERN_SOURCES)[number];
+/** Wire format for the learned_patterns table. */
+export interface LearnedPattern {
+    id: string;
+    orgId: string | null;
+    patternSql: string;
+    description: string | null;
+    sourceEntity: string | null;
+    sourceQueries: string[] | null;
+    /** Score between 0.0 (no confidence) and 1.0 (full confidence). */
+    confidence: number;
+    repetitionCount: number;
+    status: LearnedPatternStatus;
+    proposedBy: LearnedPatternSource | null;
+    reviewedBy: string | null;
+    createdAt: string;
+    updatedAt: string;
+    reviewedAt: string | null;
+}

package/dist/model-config.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Workspace-level model configuration types shared across API, frontend, and SDK.
+ *
+ * Enterprise customers can configure their own LLM provider and API key per
+ * workspace, overriding the platform default. Supported providers: Anthropic,
+ * OpenAI, Azure OpenAI, and custom OpenAI-compatible endpoints.
+ */
+export declare const MODEL_CONFIG_PROVIDERS: readonly ["anthropic", "openai", "azure-openai", "custom"];
+export type ModelConfigProvider = (typeof MODEL_CONFIG_PROVIDERS)[number];
+export interface WorkspaceModelConfig {
+    id: string;
+    orgId: string;
+    provider: ModelConfigProvider;
+    model: string;
+    /** Base URL — required for azure-openai and custom providers. */
+    baseUrl: string | null;
+    /** API key masked to last 4 characters (never sent in full). */
+    apiKeyMasked: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SetWorkspaceModelConfigRequest {
+    provider: ModelConfigProvider;
+    model: string;
+    /** Omit to keep the existing key on update. Required on initial creation. */
+    apiKey?: string;
+    /** Required for azure-openai and custom providers. */
+    baseUrl?: string;
+}
+export interface TestModelConfigRequest {
+    provider: ModelConfigProvider;
+    model: string;
+    apiKey: string;
+    baseUrl?: string;
+}
+export interface TestModelConfigResponse {
+    success: boolean;
+    message: string;
+    /** Model name returned by the provider, if available. */
+    modelName?: string;
+}

package/dist/onboarding-email.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Onboarding email sequence types shared across API and frontend.
+ *
+ * Defines the email steps, milestone triggers, and tracking state for
+ * the automated drip campaign sent to new users.
+ */
+export declare const ONBOARDING_EMAIL_STEPS: readonly ["welcome", "connect_database", "first_query", "invite_team", "explore_features"];
+export type OnboardingEmailStep = (typeof ONBOARDING_EMAIL_STEPS)[number];
+export declare const ONBOARDING_MILESTONES: readonly ["signup_completed", "database_connected", "first_query_executed", "team_member_invited", "feature_explored"];
+export type OnboardingMilestone = (typeof ONBOARDING_MILESTONES)[number];
+/** Trigger source for an onboarding email — either a milestone or a time-based fallback. */
+export type OnboardingEmailTrigger = OnboardingMilestone | "time_based";
+export interface OnboardingEmailRecord {
+    id: string;
+    userId: string;
+    orgId: string;
+    step: OnboardingEmailStep;
+    sentAt: string;
+    /** The milestone that triggered this email, or "time_based" for fallback nudges. */
+    triggeredBy: OnboardingEmailTrigger;
+}
+export interface OnboardingEmailStatus {
+    userId: string;
+    email: string;
+    orgId: string;
+    /** Steps that have been sent. Together with pendingSteps, partitions all OnboardingEmailStep values. */
+    sentSteps: OnboardingEmailStep[];
+    /** Steps remaining. Complement of sentSteps against the full sequence. */
+    pendingSteps: OnboardingEmailStep[];
+    /** Whether the user has unsubscribed from onboarding emails. */
+    unsubscribed: boolean;
+    createdAt: string;
+}
+export interface OnboardingEmailPreferences {
+    userId: string;
+    onboardingEmails: boolean;
+    updatedAt: string;
+}
+/** @deprecated Use OnboardingEmailPreferences instead. */
+export type EmailPreferences = OnboardingEmailPreferences;

package/dist/organization.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Organization types shared across API, frontend, and SDK.
+ *
+ * These align with Better Auth's organization plugin schema.
+ * Atlas uses organizations as the tenant boundary — all data
+ * (conversations, audit logs, connections, etc.) is scoped to an org.
+ */
+import type { AtlasRole } from "./auth";
+export interface Organization {
+    id: string;
+    name: string;
+    slug: string;
+    logo?: string | null;
+    metadata?: Record<string, unknown> | null;
+    createdAt: string;
+}
+export interface OrgMember {
+    id: string;
+    organizationId: string;
+    userId: string;
+    role: OrgRole;
+    createdAt: string;
+    user?: {
+        id: string;
+        name: string;
+        email: string;
+        image?: string | null;
+    };
+}
+export interface OrgInvitation {
+    id: string;
+    organizationId: string;
+    email: string;
+    role: OrgRole;
+    status: "pending" | "accepted" | "rejected" | "canceled";
+    inviterId: string;
+    expiresAt: string;
+    createdAt: string;
+    organization?: {
+        id: string;
+        name: string;
+        slug: string;
+    };
+}
+/**
+ * Org roles in descending privilege order. Same values as AtlasRole,
+ * listed high-to-low for display. Single source of truth is ATLAS_ROLES
+ * in auth.ts — this is a reversed view for convenience.
+ */
+export declare const ORG_ROLES: readonly AtlasRole[];
+export type OrgRole = AtlasRole;