@wppconnect/wa-js 3.19.8 → 3.20.0

package/CHANGELOG.md

@@ -1,4 +1,9 @@
-## 3.19.8 (2026-01-19)
+# 3.20.0 (2026-01-21)
+
+
+### Features
+
+* Ability to manage whatsapp theme  ([#3233](https://github.com/wppconnect-team/wa-js/issues/3233)) ([9530a49](https://github.com/wppconnect-team/wa-js/commit/9530a497db49704215668fa068b5a0c1fe06b9f8))
 
 
 

package/dist/conn/functions/getAutoDownloadSettings.d.ts

@@ -0,0 +1,34 @@
+/*!
+ * Copyright 2026 WPPConnect Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Get auto-download settings for media types
+ *
+ * @example
+ * ```javascript
+ * // Get current settings
+ * const settings = WPP.conn.getAutoDownloadSettings();
+ * console.log(settings);
+ * // { photos: true, audio: true, videos: false, documents: false }
+ * ```
+ *
+ * @category Config
+ */
+export declare function getAutoDownloadSettings(): {
+    photos: boolean;
+    audio: boolean;
+    videos: boolean;
+    documents: boolean;
+};

package/dist/conn/functions/getTheme.d.ts

@@ -0,0 +1,39 @@
+/*!
+ * Copyright 2026 WPPConnect Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export declare enum Theme {
+    LIGHT = "light",
+    DARK = "dark",
+    SYSTEM = "system"
+}
+/**
+ * Get current theme setting
+ *
+ * @example
+ * ```javascript
+ * // Get current theme
+ * const theme = WPP.conn.getTheme();
+ * console.log(theme); // "light", "dark", or "system"
+ *
+ * // Using enum
+ * import { Theme } from '@wppconnect/wa-js';
+ * if (theme === Theme.DARK) {
+ *   console.log('Dark mode is enabled');
+ * }
+ * ```
+ *
+ * @category Config
+ */
+export declare function getTheme(): Theme;

package/dist/conn/functions/index.d.ts

@@ -17,12 +17,14 @@ export { changeEnviromentDevice } from './changeEnviromentDevice';
 export { genLinkDeviceCodeForPhoneNumber } from './genLinkDeviceCodeForPhoneNumber';
 export { ABPropConfig, getABPropName, getABProps, getABPropsMap, } from './getABProps';
 export { getAuthCode } from './getAuthCode';
+export { getAutoDownloadSettings } from './getAutoDownloadSettings';
 export { BuildConstants, getBuildConstants, isWhatsAppVersionGTE, } from './getBuildConstants';
 export { getHistorySyncProgress, HistorySyncProgress, } from './getHistorySyncProgress';
 export { getMigrationState, MigrationState } from './getMigrationState';
 export { getMyDeviceId } from './getMyDeviceId';
 export { getMyUserId } from './getMyUserId';
 export { getPlatform } from './getPlatform';
+export { getTheme, Theme } from './getTheme';
 export { isAuthenticated } from './isAuthenticated';
 export { isIdle } from './isIdle';
 export { isMainInit } from './isMainInit';
@@ -36,6 +38,8 @@ export { logout } from './logout';
 export { markAvailable, markUnavailable } from './markAvailable';
 export { needsUpdate } from './needsUpdate';
 export { refreshQR } from './refreshQR';
+export { AutoDownloadSettings, setAutoDownloadSettings, } from './setAutoDownloadSettings';
 export { setKeepAlive } from './setKeepAlive';
 export { setLimit } from './setLimit';
 export { setMultiDevice } from './setMultiDevice';
+export { setTheme } from './setTheme';

package/dist/conn/functions/setAutoDownloadSettings.d.ts

@@ -0,0 +1,56 @@
+/*!
+ * Copyright 2026 WPPConnect Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export interface AutoDownloadSettings {
+    /**
+     * Enable/disable auto-download for photos
+     */
+    photos?: boolean;
+    /**
+     * Enable/disable auto-download for audio
+     */
+    audio?: boolean;
+    /**
+     * Enable/disable auto-download for videos
+     */
+    videos?: boolean;
+    /**
+     * Enable/disable auto-download for documents
+     */
+    documents?: boolean;
+}
+/**
+ * Set auto-download settings for media types
+ *
+ * @example
+ * ```javascript
+ * // Disable video and document auto-download
+ * await WPP.conn.setAutoDownloadSettings({
+ *   videos: false,
+ *   documents: false
+ * });
+ *
+ * // Enable only photos
+ * await WPP.conn.setAutoDownloadSettings({
+ *   photos: true,
+ *   audio: false,
+ *   videos: false,
+ *   documents: false
+ * });
+ * ```
+ *
+ * @category Config
+ */
+export declare function setAutoDownloadSettings(settings: AutoDownloadSettings): Promise<void>;

package/dist/conn/functions/setTheme.d.ts

@@ -0,0 +1,36 @@
+/*!
+ * Copyright 2026 WPPConnect Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Theme } from './getTheme';
+/**
+ * Set theme and reload the page to apply changes
+ *
+ * @example
+ * ```javascript
+ * // Using Enum
+ * import { Theme } from '@wppconnect/wa-js';
+ * await WPP.conn.setTheme(Theme.LIGHT);
+ * await WPP.conn.setTheme(Theme.DARK);
+ * await WPP.conn.setTheme(Theme.SYSTEM);
+ *
+ * // Using string ("light", "dark", "system")
+ * await WPP.conn.setTheme("light");
+ * await WPP.conn.setTheme("dark");
+ * await WPP.conn.setTheme("system");
+ * ```
+ *
+ * @category Config
+ */
+export declare function setTheme(theme: Theme): Promise<void>;

package/dist/whatsapp/misc/UserPrefsGeneral.d.ts

@@ -0,0 +1,67 @@
+/*!
+ * Copyright 2026 WPPConnect Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Get auto-download setting for photos
+ * @whatsapp WAWebUserPrefsGeneral >= 2.3000.0
+ */
+export declare function getAutoDownloadPhotos(): boolean;
+/**
+ * Set auto-download setting for photos
+ * @whatsapp WAWebUserPrefsGeneral >= 2.3000.0
+ */
+export declare function setAutoDownloadPhotos(value: boolean): void;
+/**
+ * Get auto-download setting for audio
+ * @whatsapp WAWebUserPrefsGeneral >= 2.3000.0
+ */
+export declare function getAutoDownloadAudio(): boolean;
+/**
+ * Set auto-download setting for audio
+ * @whatsapp WAWebUserPrefsGeneral >= 2.3000.1032022795
+ */
+export declare function setAutoDownloadAudio(value: boolean): void;
+/**
+ * Get auto-download setting for videos
+ * @whatsapp WAWebUserPrefsGeneral >= 2.3000.1032022795
+ */
+export declare function getAutoDownloadVideos(): boolean;
+/**
+ * Set auto-download setting for videos
+ * @whatsapp WAWebUserPrefsGeneral >= 2.3000.1032022795
+ */
+export declare function setAutoDownloadVideos(value: boolean): void;
+/**
+ * Get auto-download setting for documents
+ * @whatsapp WAWebUserPrefsGeneral >= 2.3000.1032022795
+ */
+export declare function getAutoDownloadDocuments(): boolean;
+/**
+ * Set auto-download setting for documents
+ * @whatsapp WAWebUserPrefsGeneral >= 2.3000.1032022795
+ */
+export declare function setAutoDownloadDocuments(value: boolean): void;
+/**
+ * Get theme setting
+ * @whatsapp WAWebUserPrefsGeneral >= 2.3000.1032022795
+ * @returns Theme value: "light" or "dark"
+ */
+export declare function getTheme(): string;
+/**
+ * Set theme setting
+ * @whatsapp WAWebUserPrefsGeneral >= 2.3000.1032022795
+ * @param value Theme value: "light" or "dark"
+ */
+export declare function setTheme(value: string): void;

package/dist/whatsapp/misc/index.d.ts

@@ -45,6 +45,7 @@ export * from './Socket';
 export * from './Stream';
 export * from './UsernameGatingUtils';
 export * from './UserPrefs';
+export * from './UserPrefsGeneral';
 export * from './USyncQuery';
 export * from './USyncUser';
 export * from './VCard';