@botpress/cognitive 0.1.44 → 0.1.46

package/dist/index.d.ts

@@ -214,6 +214,7 @@ type CognitiveProps = {
     maxRetries?: number;
     /** Whether to use the beta client. Restricted to authorized users. */
     __experimental_beta?: boolean;
+    __debug?: boolean;
 };
 type Events = {
     aborted: (req: Request, reason?: string) => void;
@@ -1026,6 +1027,7 @@ type ClientConfig = {
     headers: Headers;
     withCredentials: boolean;
     timeout: number;
+    debug: boolean;
 };
 
 type CommonClientProps = {
@@ -1033,6 +1035,7 @@ type CommonClientProps = {
     timeout?: number;
     headers?: Headers;
     retry?: RetryConfig;
+    debug?: boolean;
 };
 type SimplifyTuple<T> = T extends [...infer A] ? {
     [K in keyof A]: Simplify<A[K]>;
@@ -18069,12 +18072,12 @@ declare class Client extends Client$1 implements IClient {
             pictureUrl?: string;
         }>;
         events: (props: {
+            status?: "pending" | "ignored" | "processed" | "failed" | "scheduled" | undefined;
             type?: string | undefined;
             userId?: string | undefined;
             conversationId?: string | undefined;
             workflowId?: string | undefined;
             messageId?: string | undefined;
-            status?: "pending" | "ignored" | "processed" | "failed" | "scheduled" | undefined;
         }) => AsyncCollection<{
             id: string;
             createdAt: string;
@@ -18125,13 +18128,13 @@ declare class Client extends Client$1 implements IClient {
             pictureUrl?: string;
         }>;
         tasks: (props: {
+            status?: ("timeout" | "pending" | "failed" | "in_progress" | "completed" | "blocked" | "paused" | "cancelled")[] | undefined;
             tags?: {
                 [x: string]: string;
             } | undefined;
             type?: string | undefined;
             userId?: string | undefined;
             conversationId?: string | undefined;
-            status?: ("pending" | "failed" | "in_progress" | "completed" | "blocked" | "paused" | "timeout" | "cancelled")[] | undefined;
             parentTaskId?: string | undefined;
         }) => AsyncCollection<{
             id: string;
@@ -18964,6 +18967,7 @@ declare class Cognitive {
     protected _provider: ModelProvider;
     protected _downtimes: ModelPreferences['downtimes'];
     protected _useBeta: boolean;
+    protected _debug: boolean;
     private _events;
     constructor(props: CognitiveProps);
     get client(): ExtendedClient;
@@ -18979,7 +18983,7 @@ declare class Cognitive {
     private _generateContent;
 }
 
-type Models = 'auto' | 'best' | 'fast' | 'reasoning' | 'cheapest' | 'balance' | 'recommended' | 'reasoning' | 'general-purpose' | 'low-cost' | 'vision' | 'coding' | 'function-calling' | 'agents' | 'storytelling' | 'preview' | 'roleplay' | 'anthropic:claude-3-5-haiku-20241022' | 'anthropic:claude-3-5-sonnet-20240620' | 'anthropic:claude-3-5-sonnet-20241022' | 'anthropic:claude-3-7-sonnet-20250219' | 'anthropic:claude-3-haiku-20240307' | 'anthropic:claude-sonnet-4-20250514' | 'cerebras:gpt-oss-120b' | 'cerebras:llama-4-scout-17b-16e-instruct' | 'cerebras:llama3.1-8b' | 'cerebras:llama3.3-70b' | 'cerebras:qwen-3-32b' | 'fireworks-ai:deepseek-r1' | 'fireworks-ai:deepseek-r1-0528' | 'fireworks-ai:deepseek-r1-basic' | 'fireworks-ai:deepseek-v3-0324' | 'fireworks-ai:gpt-oss-120b' | 'fireworks-ai:gpt-oss-20b' | 'fireworks-ai:llama-v3p1-8b-instruct' | 'fireworks-ai:llama-v3p3-70b-instruct' | 'fireworks-ai:llama4-maverick-instruct-basic' | 'fireworks-ai:llama4-scout-instruct-basic' | 'fireworks-ai:mixtral-8x22b-instruct' | 'fireworks-ai:mixtral-8x7b-instruct' | 'fireworks-ai:mythomax-l2-13b' | 'google-ai:gemini-2.5-flash' | 'google-ai:gemini-2.5-pro' | 'google-ai:models/gemini-2.0-flash' | 'groq:deepseek-r1-distill-llama-70b' | 'groq:gemma2-9b-it' | 'groq:llama-3.1-8b-instant' | 'groq:llama-3.3-70b-versatile' | 'groq:openai/gpt-oss-120b' | 'groq:openai/gpt-oss-20b' | 'openai:gpt-4.1-2025-04-14' | 'openai:gpt-4.1-mini-2025-04-14' | 'openai:gpt-4.1-nano-2025-04-14' | 'openai:gpt-4o-2024-11-20' | 'openai:gpt-4o-mini-2024-07-18' | 'openai:gpt-5-2025-08-07' | 'openai:gpt-5-mini-2025-08-07' | 'openai:gpt-5-nano-2025-08-07' | 'openai:o1-2024-12-17' | 'openai:o1-mini-2024-09-12' | 'openai:o3-2025-04-16' | 'openai:o3-mini-2025-01-31' | 'openai:o4-mini-2025-04-16' | 'openrouter:gpt-oss-120b' | 'xai:grok-3' | 'xai:grok-3-mini' | 'xai:grok-4-0709' | 'xai:grok-4-fast-non-reasoning' | 'xai:grok-4-fast-reasoning' | 'xai:grok-code-fast-1' | ({} & string);
+type Models = 'auto' | 'best' | 'fast' | 'anthropic:claude-3-5-haiku-20241022' | 'anthropic:claude-3-5-sonnet-20240620' | 'anthropic:claude-3-5-sonnet-20241022' | 'anthropic:claude-3-7-sonnet-20250219' | 'anthropic:claude-3-haiku-20240307' | 'anthropic:claude-sonnet-4-20250514' | 'anthropic:claude-sonnet-4-5-2025092' | 'cerebras:gpt-oss-120b' | 'cerebras:llama-4-scout-17b-16e-instruct' | 'cerebras:llama3.1-8b' | 'cerebras:llama3.3-70b' | 'cerebras:qwen-3-32b' | 'fireworks-ai:deepseek-r1-0528' | 'fireworks-ai:deepseek-v3-0324' | 'fireworks-ai:gpt-oss-120b' | 'fireworks-ai:gpt-oss-20b' | 'fireworks-ai:llama-v3p1-8b-instruct' | 'fireworks-ai:llama-v3p3-70b-instruct' | 'fireworks-ai:llama4-maverick-instruct-basic' | 'fireworks-ai:llama4-scout-instruct-basic' | 'fireworks-ai:mixtral-8x7b-instruct' | 'fireworks-ai:mythomax-l2-13b' | 'google-ai:gemini-2.5-flash' | 'google-ai:gemini-2.5-pro' | 'google-ai:models/gemini-2.0-flash' | 'groq:deepseek-r1-distill-llama-70b' | 'groq:gemma2-9b-it' | 'groq:gpt-oss-120b' | 'groq:gpt-oss-20b' | 'groq:llama-3.1-8b-instant' | 'groq:llama-3.3-70b-versatile' | 'openai:gpt-4.1-2025-04-14' | 'openai:gpt-4.1-mini-2025-04-14' | 'openai:gpt-4.1-nano-2025-04-14' | 'openai:gpt-4o-2024-11-20' | 'openai:gpt-4o-mini-2024-07-18' | 'openai:gpt-5-2025-08-07' | 'openai:gpt-5-mini-2025-08-07' | 'openai:gpt-5-nano-2025-08-07' | 'openai:o1-2024-12-17' | 'openai:o1-mini-2024-09-12' | 'openai:o3-2025-04-16' | 'openai:o3-mini-2025-01-31' | 'openai:o4-mini-2025-04-16' | 'openrouter:gpt-oss-120b' | 'xai:grok-3' | 'xai:grok-3-mini' | 'xai:grok-4-0709' | 'xai:grok-4-fast-non-reasoning' | 'xai:grok-4-fast-reasoning' | 'xai:grok-code-fast-1' | 'openai:gpt-5' | 'openai:gpt-5-mini' | 'openai:gpt-5-nano' | 'openai:o4-mini' | 'openai:o3' | 'openai:gpt-4.1' | 'openai:gpt-4.1-mini' | 'openai:gpt-4.1-nano' | 'openai:o3-mini' | 'openai:o1-mini' | 'openai:gpt-4o-mini' | 'openai:gpt-4o' | 'anthropic:claude-sonnet-4-5' | 'anthropic:claude-sonnet-4' | 'anthropic:claude-sonnet-4-reasoning' | 'groq:openai/gpt-oss-20b' | 'groq:openai/gpt-oss-120b' | 'fireworks-ai:accounts/fireworks/models/gpt-oss-20b' | 'fireworks-ai:accounts/fireworks/models/gpt-oss-120b' | 'fireworks-ai:accounts/fireworks/models/deepseek-r1-0528' | 'fireworks-ai:accounts/fireworks/models/deepseek-v3-0324' | 'fireworks-ai:accounts/fireworks/models/llama4-maverick-instruct-basic' | 'fireworks-ai:accounts/fireworks/models/llama4-scout-instruct-basic' | 'fireworks-ai:accounts/fireworks/models/llama-v3p3-70b-instruct' | 'fireworks-ai:accounts/fireworks/models/deepseek-r1' | 'fireworks-ai:accounts/fireworks/models/deepseek-r1-basic' | 'fireworks-ai:accounts/fireworks/models/deepseek-v3' | 'fireworks-ai:accounts/fireworks/models/llama-v3p1-405b-instruct' | 'fireworks-ai:accounts/fireworks/models/llama-v3p1-70b-instruct' | 'fireworks-ai:accounts/fireworks/models/llama-v3p1-8b-instruct' | 'fireworks-ai:accounts/fireworks/models/mixtral-8x22b-instruct' | 'fireworks-ai:accounts/fireworks/models/mixtral-8x7b-instruct' | 'fireworks-ai:accounts/fireworks/models/mythomax-l2-13b' | 'fireworks-ai:accounts/fireworks/models/gemma2-9b-it' | ({} & string);
 type CognitiveRequest = {
     /**
      * @minItems 1
@@ -19050,6 +19054,7 @@ type CognitiveStreamChunk = {
 };
 type CognitiveResponse = {
     output: string;
+    reasoning?: string;
     metadata: {
         provider: string;
         model?: string;
@@ -19068,7 +19073,7 @@ type CognitiveResponse = {
         stopReason?: 'stop' | 'length' | 'content_filter' | 'error';
         reasoningEffort?: string;
         warnings?: {
-            type: 'parameter_ignored' | 'provider_limitation' | 'deprecated_model' | 'fallback_used';
+            type: 'parameter_ignored' | 'provider_limitation' | 'deprecated_model' | 'discontinued_model' | 'fallback_used';
             message: string;
         }[];
         /**
@@ -19116,19 +19121,23 @@ type ClientProps = {
     botId?: string;
     token?: string;
     withCredentials?: boolean;
+    debug?: boolean;
     headers?: Record<string, string>;
 };
 type RequestOptions = {
     signal?: AbortSignal;
     timeout?: number;
 };
+
 declare class CognitiveBeta {
     private _axiosClient;
     private readonly _apiUrl;
     private readonly _timeout;
     private readonly _withCredentials;
     private readonly _headers;
+    private readonly _debug;
     constructor(props: ClientProps);
+    clone(): CognitiveBeta;
     generateText(input: CognitiveRequest, options?: RequestOptions): Promise<CognitiveResponse>;
     listModels(): Promise<Model[]>;
     generateTextStream(request: CognitiveRequest, options?: RequestOptions): AsyncGenerator<CognitiveStreamChunk, void, unknown>;
@@ -19138,4 +19147,4 @@ declare class CognitiveBeta {
 }
 declare const getCognitiveV2Model: (model: string) => Model | undefined;
 
-export { type BotpressClientLike, Cognitive, CognitiveBeta, type CognitiveRequest, type CognitiveResponse, type CognitiveStreamChunk, type Events, type GenerateContentInput, type GenerateContentOutput, type Model$1 as Model, type ModelPreferences, ModelProvider, RemoteModelProvider, getCognitiveV2Model };
+export { type BotpressClientLike, Cognitive, CognitiveBeta, type CognitiveRequest, type CognitiveResponse, type CognitiveStreamChunk, type Events, type GenerateContentInput, type GenerateContentOutput, type Model$1 as Model, type ModelPreferences, ModelProvider, type Models, RemoteModelProvider, getCognitiveV2Model };

package/dist/index.mjs

@@ -649,7 +649,8 @@ var models = {
       costPer1MTokens: 10
     },
     tags: ["recommended", "reasoning", "general-purpose"],
-    lifecycle: "live"
+    lifecycle: "live",
+    aliases: ["gpt-5"]
   },
   "openai:gpt-5-mini-2025-08-07": {
     id: "openai:gpt-5-mini-2025-08-07",
@@ -664,7 +665,8 @@ var models = {
       costPer1MTokens: 2
     },
     tags: ["recommended", "reasoning", "general-purpose"],
-    lifecycle: "live"
+    lifecycle: "live",
+    aliases: ["gpt-5-mini"]
   },
   "openai:gpt-5-nano-2025-08-07": {
     id: "openai:gpt-5-nano-2025-08-07",
@@ -679,7 +681,8 @@ var models = {
       costPer1MTokens: 0.4
     },
     tags: ["low-cost", "reasoning", "general-purpose"],
-    lifecycle: "live"
+    lifecycle: "live",
+    aliases: ["gpt-5-nano"]
   },
   "openai:o4-mini-2025-04-16": {
     id: "openai:o4-mini-2025-04-16",
@@ -694,7 +697,8 @@ var models = {
       costPer1MTokens: 4.4
     },
     tags: ["reasoning", "vision", "coding"],
-    lifecycle: "live"
+    lifecycle: "live",
+    aliases: ["o4-mini"]
   },
   "openai:o3-2025-04-16": {
     id: "openai:o3-2025-04-16",
@@ -709,7 +713,8 @@ var models = {
       costPer1MTokens: 8
     },
     tags: ["reasoning", "vision", "coding"],
-    lifecycle: "live"
+    lifecycle: "live",
+    aliases: ["o3"]
   },
   "openai:gpt-4.1-2025-04-14": {
     id: "openai:gpt-4.1-2025-04-14",
@@ -724,7 +729,8 @@ var models = {
       costPer1MTokens: 8
     },
     tags: ["recommended", "vision", "general-purpose"],
-    lifecycle: "live"
+    lifecycle: "live",
+    aliases: ["gpt-4.1"]
   },
   "openai:gpt-4.1-mini-2025-04-14": {
     id: "openai:gpt-4.1-mini-2025-04-14",
@@ -739,7 +745,8 @@ var models = {
       costPer1MTokens: 1.6
     },
     tags: ["recommended", "vision", "general-purpose"],
-    lifecycle: "live"
+    lifecycle: "live",
+    aliases: ["gpt-4.1-mini"]
   },
   "openai:gpt-4.1-nano-2025-04-14": {
     id: "openai:gpt-4.1-nano-2025-04-14",
@@ -754,7 +761,8 @@ var models = {
       costPer1MTokens: 0.4
     },
     tags: ["low-cost", "vision", "general-purpose"],
-    lifecycle: "live"
+    lifecycle: "live",
+    aliases: ["gpt-4.1-nano"]
   },
   "openai:o3-mini-2025-01-31": {
     id: "openai:o3-mini-2025-01-31",
@@ -769,7 +777,8 @@ var models = {
       costPer1MTokens: 4.4
     },
     tags: ["reasoning", "general-purpose", "coding"],
-    lifecycle: "live"
+    lifecycle: "live",
+    aliases: ["o3-mini"]
   },
   "openai:o1-2024-12-17": {
     id: "openai:o1-2024-12-17",
@@ -799,7 +808,8 @@ var models = {
       costPer1MTokens: 4.4
     },
     tags: ["reasoning", "vision", "general-purpose"],
-    lifecycle: "live"
+    lifecycle: "live",
+    aliases: ["o1-mini"]
   },
   "openai:gpt-4o-mini-2024-07-18": {
     id: "openai:gpt-4o-mini-2024-07-18",
@@ -814,7 +824,8 @@ var models = {
       costPer1MTokens: 0.6
     },
     tags: ["recommended", "vision", "low-cost", "general-purpose", "function-calling"],
-    lifecycle: "live"
+    lifecycle: "live",
+    aliases: ["gpt-4o-mini"]
   },
   "openai:gpt-4o-2024-11-20": {
     id: "openai:gpt-4o-2024-11-20",
@@ -829,7 +840,8 @@ var models = {
       costPer1MTokens: 10
     },
     tags: ["recommended", "vision", "general-purpose", "coding", "agents", "function-calling"],
-    lifecycle: "live"
+    lifecycle: "live",
+    aliases: ["gpt-4o"]
   },
   "openai:gpt-4o-2024-08-06": {
     id: "openai:gpt-4o-2024-08-06",
@@ -891,6 +903,22 @@ var models = {
     tags: ["deprecated", "general-purpose", "low-cost"],
     lifecycle: "deprecated"
   },
+  "anthropic:claude-sonnet-4-5-2025092": {
+    id: "anthropic:claude-sonnet-4-5-2025092",
+    name: "Claude Sonnet 4.5",
+    description: "Claude Sonnet 4.5 is Anthropic's most advanced Sonnet model to date, optimized for real-world agents and coding workflows. It delivers state-of-the-art performance on coding benchmarks, with improvements across system design, code security, and specification adherence.",
+    input: {
+      maxTokens: 2e5,
+      costPer1MTokens: 3
+    },
+    output: {
+      maxTokens: 64e3,
+      costPer1MTokens: 15
+    },
+    tags: ["recommended", "reasoning", "agents", "vision", "general-purpose", "coding"],
+    lifecycle: "live",
+    aliases: ["claude-sonnet-4-5"]
+  },
   "anthropic:claude-sonnet-4-20250514": {
     id: "anthropic:claude-sonnet-4-20250514",
     name: "Claude Sonnet 4",
@@ -904,7 +932,8 @@ var models = {
       costPer1MTokens: 15
     },
     tags: ["recommended", "reasoning", "agents", "vision", "general-purpose", "coding"],
-    lifecycle: "live"
+    lifecycle: "live",
+    aliases: ["claude-sonnet-4"]
   },
   "anthropic:claude-sonnet-4-reasoning-20250514": {
     id: "anthropic:claude-sonnet-4-reasoning-20250514",
@@ -919,7 +948,8 @@ var models = {
       costPer1MTokens: 15
     },
     tags: ["deprecated", "vision", "reasoning", "general-purpose", "agents", "coding"],
-    lifecycle: "deprecated"
+    lifecycle: "deprecated",
+    aliases: ["claude-sonnet-4-reasoning"]
   },
   "anthropic:claude-3-7-sonnet-20250219": {
     id: "anthropic:claude-3-7-sonnet-20250219",
@@ -1131,8 +1161,8 @@ var models = {
     tags: ["general-purpose"],
     lifecycle: "live"
   },
-  "groq:openai/gpt-oss-20b": {
-    id: "groq:openai/gpt-oss-20b",
+  "groq:gpt-oss-20b": {
+    id: "groq:gpt-oss-20b",
     name: "GPT-OSS 20B (Preview)",
     description: "gpt-oss-20b is a compact, open-weight language model optimized for low-latency. It shares the same training foundation and capabilities as the GPT-OSS 120B model, with faster responses and lower cost.",
     input: {
@@ -1144,10 +1174,11 @@ var models = {
       costPer1MTokens: 0.5
     },
     tags: ["preview", "general-purpose", "reasoning", "low-cost"],
-    lifecycle: "live"
+    lifecycle: "live",
+    aliases: ["openai/gpt-oss-20b"]
   },
-  "groq:openai/gpt-oss-120b": {
-    id: "groq:openai/gpt-oss-120b",
+  "groq:gpt-oss-120b": {
+    id: "groq:gpt-oss-120b",
     name: "GPT-OSS 120B (Preview)",
     description: "gpt-oss-120b is a high-performance, open-weight language model designed for production-grade, general-purpose use cases. It excels at complex reasoning and supports configurable reasoning effort, full chain-of-thought transparency for easier debugging and trust, and native agentic capabilities for function calling, tool use, and structured outputs.",
     input: {
@@ -1159,7 +1190,8 @@ var models = {
       costPer1MTokens: 0.75
     },
     tags: ["preview", "general-purpose", "reasoning"],
-    lifecycle: "live"
+    lifecycle: "live",
+    aliases: ["openai/gpt-oss-120b"]
   },
   "groq:deepseek-r1-distill-llama-70b": {
     id: "groq:deepseek-r1-distill-llama-70b",
@@ -1541,7 +1573,7 @@ var models = {
       costPer1MTokens: 8
     },
     tags: ["reasoning", "general-purpose", "coding"],
-    lifecycle: "live",
+    lifecycle: "deprecated",
     aliases: ["accounts/fireworks/models/deepseek-r1"]
   },
   "fireworks-ai:deepseek-r1-basic": {
@@ -1556,8 +1588,8 @@ var models = {
       maxTokens: 32768,
       costPer1MTokens: 2.19
     },
-    tags: ["recommended", "reasoning", "general-purpose", "coding"],
-    lifecycle: "live",
+    tags: ["reasoning", "general-purpose", "coding"],
+    lifecycle: "deprecated",
     aliases: ["accounts/fireworks/models/deepseek-r1-basic"]
   },
   "fireworks-ai:deepseek-v3": {
@@ -1636,8 +1668,8 @@ var models = {
       maxTokens: 65536,
       costPer1MTokens: 1.2
     },
-    tags: ["general-purpose"],
-    lifecycle: "live",
+    tags: ["deprecated", "general-purpose"],
+    lifecycle: "deprecated",
     aliases: ["accounts/fireworks/models/mixtral-8x22b-instruct"]
   },
   "fireworks-ai:mixtral-8x7b-instruct": {
@@ -1689,25 +1721,6 @@ var models = {
     aliases: ["accounts/fireworks/models/gemma2-9b-it"]
   }
 };
-var knownTags = [
-  "auto",
-  "best",
-  "fast",
-  "reasoning",
-  "cheapest",
-  "balance",
-  "recommended",
-  "reasoning",
-  "general-purpose",
-  "low-cost",
-  "vision",
-  "coding",
-  "function-calling",
-  "agents",
-  "storytelling",
-  "preview",
-  "roleplay"
-];
 var defaultModel = {
   id: "",
   name: "",
@@ -1726,12 +1739,13 @@ var defaultModel = {
 
 // src/cognitive-v2/index.ts
 var isBrowser = () => typeof window !== "undefined" && typeof window.fetch === "function";
-var CognitiveBeta = class {
+var CognitiveBeta = class _CognitiveBeta {
   _axiosClient;
   _apiUrl;
   _timeout;
   _withCredentials;
   _headers;
+  _debug = false;
   constructor(props) {
     this._apiUrl = props.apiUrl || "https://api.botpress.cloud";
     this._timeout = props.timeout || 60001;
@@ -1743,12 +1757,25 @@ var CognitiveBeta = class {
     if (props.token) {
       this._headers["Authorization"] = `Bearer ${props.token}`;
     }
+    if (props.debug) {
+      this._debug = true;
+      this._headers["X-Debug"] = "1";
+    }
     this._axiosClient = axios.create({
       headers: this._headers,
       withCredentials: this._withCredentials,
       baseURL: this._apiUrl
     });
   }
+  clone() {
+    return new _CognitiveBeta({
+      apiUrl: this._apiUrl,
+      timeout: this._timeout,
+      withCredentials: this._withCredentials,
+      headers: this._headers,
+      debug: this._debug
+    });
+  }
   async generateText(input, options = {}) {
     const signal = options.signal ?? AbortSignal.timeout(this._timeout);
     const { data } = await this._withServerRetry(
@@ -1881,7 +1908,7 @@ var getCognitiveV2Model = (model) => {
   if (alias) {
     return alias;
   }
-  if (knownTags.includes(model)) {
+  if (["auto", "fast", "best"].includes(model)) {
     return { ...defaultModel, id: model, name: model };
   }
   return void 0;
@@ -2140,6 +2167,7 @@ var Cognitive = class _Cognitive {
   _provider;
   _downtimes = [];
   _useBeta = false;
+  _debug = false;
   _events = createNanoEvents();
   constructor(props) {
     this._client = getExtendedClient(props.client);
@@ -2156,7 +2184,9 @@ var Cognitive = class _Cognitive {
       client: this._client.clone(),
       provider: this._provider,
       timeout: this._timeoutMs,
-      maxRetries: this._maxRetries
+      maxRetries: this._maxRetries,
+      __debug: this._debug,
+      __experimental_beta: this._useBeta
     });
     copy._models = [...this._models];
     copy._preferences = this._preferences ? { ...this._preferences } : null;