@vinikjkkj/wa-appstate 0.1.0

package/README.md

@@ -0,0 +1,173 @@
+# @vinikjkkj/wa-appstate
+
+WhatsApp Web AppState (Syncd) action schemas — wire names, collections,
+versions, value fields, and index shapes for every multi-device sync action.
+
+```sh
+npm i @vinikjkkj/wa-appstate
+```
+
+```ts
+import { WA_APPSTATE_SCHEMAS, WA_APPSTATE_COLLECTIONS } from '@vinikjkkj/wa-appstate'
+import type {
+    WaAppstateSchema,
+    WaAppstateActionKey,
+    WaAppstateCollection,
+    WaAppstateScope,
+    WaAppstateIndexValueOf,
+    WaAppstateIndexArgs
+} from '@vinikjkkj/wa-appstate'
+
+WA_APPSTATE_SCHEMAS.Mute
+// → {
+//     name: 'mute',
+//     collection: 'regular_high',
+//     version: 2,
+//     scope: 'chat',
+//     valueField: 'muteAction',
+//     indexParts: [
+//       { type: 'literal', value: 'mute' },
+//       { type: 'wid', name: 'chatJid' }
+//     ]
+//   }
+```
+
+## Derived helpers — typed encoders/decoders
+
+`indexParts` is a discriminated-union tuple, so `type` narrows the shape
+(`literal` carries `value`, every other variant carries `name`). Two
+helpers turn that tuple into the types you actually want to use:
+
+```ts
+// Wire-level value tuple: what you'd serialise on the index
+type MuteWire = WaAppstateIndexValueOf<typeof WA_APPSTATE_SCHEMAS.Mute>
+// → readonly ['mute', string]
+
+type StarWire = WaAppstateIndexValueOf<typeof WA_APPSTATE_SCHEMAS.Star>
+// → readonly ['star', string, string, 'true' | 'false', string]
+
+// Named args object: what a typed builder would accept
+type MuteArgs = WaAppstateIndexArgs<'Mute'>
+// → { readonly chatJid: string }
+
+type StarArgs = WaAppstateIndexArgs<'Star'>
+// → { readonly remote: string; readonly id: string; readonly fromMe: boolean; readonly participant: string }
+```
+
+So a fully typed index builder is one declaration:
+
+```ts
+function buildIndex<K extends WaAppstateActionKey>(
+    key: K,
+    args: WaAppstateIndexArgs<K>
+): WaAppstateIndexValueOf<typeof WA_APPSTATE_SCHEMAS[K]> {
+    // ...your encoder here
+}
+
+buildIndex('Mute', { chatJid: '5511@c.us' })                                 // ✓
+buildIndex('Mute', { chatJld: '5511@c.us' })                                 // ✗ typo caught
+buildIndex('Star', { remote: 'r', id: 'i', fromMe: true, participant: 'p' }) // ✓
+```
+
+## What's in here
+
+WhatsApp Web's *AppState* (server-side: *Syncd*) is the multi-device
+CRDT-style protocol that syncs small per-account mutations — mute, pin,
+archive, contact, star, label, settings, etc. — across the primary
+device and every linked client.
+
+Each mutation on the wire is:
+
+- an **action wire name** (`mute`, `pin_v1`, `setting_pushName`, …) — the
+  server keys mutations by this
+- a **collection** (one of `regular`, `regular_low`, `regular_high`,
+  `critical_block`, `critical_unblock_low`) — controls sync priority and
+  whether the client must catch up before usable state
+- a **version** — bumped when the collection's *index shape* changes;
+  receivers reject older versions
+- an **index tuple** — `[name, ...]`. Rest depends on scope (e.g.
+  `[name, chatJid]` for chat-scoped actions, `[name, remote, id, fromMe,
+  participant]` for message-scoped)
+- a **value** carried inside a `SyncActionValue` oneOf field (e.g.
+  `muteAction: MuteAction`) — the protobuf payload lives in
+  [`@vinikjkkj/wa-proto`](https://www.npmjs.com/package/@vinikjkkj/wa-proto)
+
+This package gives you the static metadata for all 65+ action handlers,
+so you can build wire-level encoders/decoders or replay mutations without
+manually transcribing the client's handler registry.
+
+## What's published
+
+| File | Format | Use case |
+|---|---|---|
+| `index.js` | CommonJS | Runtime `WA_APPSTATE_SCHEMAS` + `WA_APPSTATE_COLLECTIONS` frozen tables |
+| `index.d.ts` | TS declarations | Per-action literal-typed schemas + the umbrella maps |
+
+A raw IR file (`index.json`) is also produced by the extractor — see the
+repo's [`packages/appstate/index.json`](https://github.com/vinikjkkj/wa-spec/blob/master/packages/appstate/index.json)
+for non-TS consumers (diff tools, codegen, other languages).
+
+`index.json` shape:
+
+```jsonc
+{
+  "waVersion": "2.3000.xxxxx",
+  "collections": ["regular", "regular_low", "regular_high", "critical_block", "critical_unblock_low"],
+  "actions": {
+    "Mute": {
+      "module": "WAWebMuteChatSync",
+      "name": "mute",
+      "collection": "regular_high",
+      "version": 2,
+      "scope": "chat",
+      "baseClass": "ChatSyncdActionBase",
+      "valueField": "muteAction",
+      "chatJidIndex": 1,
+      "indexParts": [
+        { "type": "literal", "value": "mute" },
+        { "type": "wid", "name": "chatJid" }
+      ]
+    }
+  }
+}
+```
+
+## Scopes
+
+Each handler extends one of five base classes from `WAWebSyncdAction`,
+which dictates the index shape:
+
+| Scope | Index shape | Examples |
+|---|---|---|
+| `account` | `[name]` or `[name, opaqueId]` | `setting_pushName`, `time_format`, `label_edit`, `deviceAgent` |
+| `chat` | `[name, chatJid]` | `mute`, `pin_v1`, `clearChat`, `lock` |
+| `chatOrContact` | `[name, ...]` — typically `[name, labelId, chatJid]` | `label_jid` |
+| `message` | `[name, remote, id, fromMe, participant]` | `star`, `deleteMessageForMe` |
+| `chatMessageRange` | `[name, chatJid]` (message range carried in `value`) | `archive`, `markChatAsRead` |
+
+## Generate locally
+
+```sh
+npx wa-fetcher --out dump/                  # download bundles
+npx wa-appstate apply --bundles dump/raw/<version>/
+```
+
+## Caveats
+
+- **`valueField: null` means the handler doesn't read from the protobuf
+  value.** A handful of actions (e.g. `ai_thread_delete`, `shareOwnPn`,
+  `marketingMessageBroadcast`) ignore the value entirely — the wire
+  mutation is index-only. The `SyncActionValue` oneOf field may still
+  exist in the protobuf; check [`@vinikjkkj/wa-proto`](https://www.npmjs.com/package/@vinikjkkj/wa-proto)
+  if you need the encoder/decoder.
+- **Slot names beyond `action` / `chatJid` / message-key tuples are
+  generic (`key1`, `key2`, …).** The minified handler doesn't carry
+  human-readable parameter names; we tag what we can recognise from the
+  scope's base class and fall back to positional names. The encoded
+  value is still correct — only the *label* is generic.
+- **Slot 0 is always the action wire name itself** — the client prepends
+  it to the indexArgs array before computing the index hash.
+- **The handler registry is `WAWebCollectionHandlerActions`.** Anything
+  added or removed in WA Web shows up here on the next daily extract.
+
+Daily-extracted by [wa-spec](https://github.com/vinikjkkj/wa-spec).

package/index.d.ts

@@ -0,0 +1,152 @@
+// AUTO-GENERATED — do not edit. Regenerated daily by wa-spec.
+// WhatsApp Version: 2.3000.1040072419
+
+export type WaAppstateCollection = 'regular' | 'regular_low' | 'regular_high' | 'critical_block' | 'critical_unblock_low'
+
+export type WaAppstateScope =
+    | 'account'
+    | 'chat'
+    | 'chatOrContact'
+    | 'message'
+    | 'chatMessageRange'
+
+// Discriminated union — `type` narrows the shape:
+//   - 'literal' carries a fixed `value` (the action wire name, position 0)
+//   - everything else carries a `name` (the role of the slot)
+export type WaAppstateIndexPart =
+    | { readonly type: 'literal'; readonly value: string }
+    | { readonly type: 'wid'; readonly name: string }
+    | { readonly type: 'jid'; readonly name: string }
+    | { readonly type: 'string'; readonly name: string }
+    | { readonly type: 'boolString'; readonly name: string }
+    | { readonly type: 'unknown'; readonly name: string }
+
+export interface WaAppstateSchema<
+    Name extends string = string,
+    Collection extends WaAppstateCollection = WaAppstateCollection,
+    Scope extends WaAppstateScope = WaAppstateScope,
+    ValueField extends string | null = string | null,
+    IndexParts extends ReadonlyArray<WaAppstateIndexPart> = ReadonlyArray<WaAppstateIndexPart>
+> {
+    readonly name: Name
+    readonly collection: Collection
+    readonly version: number
+    readonly scope: Scope
+    readonly valueField: ValueField
+    readonly indexParts: IndexParts
+}
+
+export declare const WA_APPSTATE_COLLECTIONS: ReadonlyArray<WaAppstateCollection>
+
+export declare const WA_APPSTATE_SCHEMAS: {
+    readonly AdsCtwaPerCustomerDataSharing: WaAppstateSchema<'ctwaPerCustomerDataSharing', 'regular_high', 'account', 'ctwaPerCustomerDataSharingAction', readonly [{ readonly type: 'literal'; readonly value: 'ctwaPerCustomerDataSharing' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly Agent: WaAppstateSchema<'deviceAgent', 'regular', 'account', 'agentAction', readonly [{ readonly type: 'literal'; readonly value: 'deviceAgent' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly AiThreadDelete: WaAppstateSchema<'ai_thread_delete', 'regular_high', 'chat', null, readonly [{ readonly type: 'literal'; readonly value: 'ai_thread_delete' }, { readonly type: 'wid'; readonly name: 'chatJid' }, { readonly type: 'string'; readonly name: 'key2' }]>
+    readonly AiThreadPin: WaAppstateSchema<'thread_pin', 'regular_low', 'chat', 'threadPinAction', readonly [{ readonly type: 'literal'; readonly value: 'thread_pin' }, { readonly type: 'wid'; readonly name: 'chatJid' }, { readonly type: 'string'; readonly name: 'key2' }]>
+    readonly AiThreadRename: WaAppstateSchema<'ai_thread_rename', 'regular_low', 'chat', 'aiThreadRenameAction', readonly [{ readonly type: 'literal'; readonly value: 'ai_thread_rename' }, { readonly type: 'wid'; readonly name: 'chatJid' }, { readonly type: 'string'; readonly name: 'key2' }]>
+    readonly AndroidUnsupportedActions: WaAppstateSchema<'android_unsupported_actions', 'regular_low', 'account', 'androidUnsupportedActions', readonly [{ readonly type: 'literal'; readonly value: 'android_unsupported_actions' }]>
+    readonly Archive: WaAppstateSchema<'archive', 'regular_low', 'chatMessageRange', 'archiveChatAction', readonly [{ readonly type: 'literal'; readonly value: 'archive' }, { readonly type: 'wid'; readonly name: 'chatJid' }]>
+    readonly AvatarUpdated: WaAppstateSchema<'avatar_updated_action', 'regular', 'account', 'avatarUpdatedAction', readonly [{ readonly type: 'literal'; readonly value: 'avatar_updated_action' }]>
+    readonly BizAiSettingsNudge: WaAppstateSchema<'biz_ai_settings_nudge', 'regular_high', 'account', 'bizAiSettingsNudgeAction', readonly [{ readonly type: 'literal'; readonly value: 'biz_ai_settings_nudge' }]>
+    readonly BotWelcomeRequest: WaAppstateSchema<'bot_welcome_request', 'regular_low', 'chat', 'botWelcomeRequestAction', readonly [{ readonly type: 'literal'; readonly value: 'bot_welcome_request' }, { readonly type: 'wid'; readonly name: 'chatJid' }]>
+    readonly BusinessBroadcastCampaign: WaAppstateSchema<'business_broadcast_campaign', 'regular', 'account', 'businessBroadcastCampaignAction', readonly [{ readonly type: 'literal'; readonly value: 'business_broadcast_campaign' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly BusinessBroadcastInsights: WaAppstateSchema<'business_broadcast_insights_sync', 'regular', 'account', 'businessBroadcastInsightsAction', readonly [{ readonly type: 'literal'; readonly value: 'business_broadcast_insights_sync' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly BusinessBroadcastList: WaAppstateSchema<'business_broadcast_list', 'regular', 'account', 'businessBroadcastListAction', readonly [{ readonly type: 'literal'; readonly value: 'business_broadcast_list' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly CallLog: WaAppstateSchema<'call_log', 'regular', 'account', 'callLogAction', readonly [{ readonly type: 'literal'; readonly value: 'call_log' }]>
+    readonly ChatAssignment: WaAppstateSchema<'agentChatAssignment', 'regular', 'chat', 'chatAssignment', readonly [{ readonly type: 'literal'; readonly value: 'agentChatAssignment' }, { readonly type: 'wid'; readonly name: 'chatJid' }]>
+    readonly ChatAssignmentOpenedStatus: WaAppstateSchema<'agentChatAssignmentOpenedStatus', 'regular', 'chat', 'chatAssignmentOpenedStatus', readonly [{ readonly type: 'literal'; readonly value: 'agentChatAssignmentOpenedStatus' }, { readonly type: 'wid'; readonly name: 'chatJid' }, { readonly type: 'string'; readonly name: 'key2' }]>
+    readonly ChatLockSettings: WaAppstateSchema<'setting_chatLock', 'regular_low', 'account', 'chatLockSettings', readonly [{ readonly type: 'literal'; readonly value: 'setting_chatLock' }]>
+    readonly ClearChat: WaAppstateSchema<'clearChat', 'regular_high', 'chatMessageRange', 'clearChatAction', readonly [{ readonly type: 'literal'; readonly value: 'clearChat' }, { readonly type: 'wid'; readonly name: 'chatJid' }, { readonly type: 'string'; readonly name: 'key2' }, { readonly type: 'string'; readonly name: 'key3' }]>
+    readonly Contact: WaAppstateSchema<'contact', 'critical_unblock_low', 'account', 'contactAction', readonly [{ readonly type: 'literal'; readonly value: 'contact' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly CustomPaymentMethods: WaAppstateSchema<'custom_payment_methods', 'regular_low', 'account', 'customPaymentMethodsAction', readonly [{ readonly type: 'literal'; readonly value: 'custom_payment_methods' }]>
+    readonly CustomerData: WaAppstateSchema<'customer_data', 'regular_low', 'account', 'customerDataAction', readonly [{ readonly type: 'literal'; readonly value: 'customer_data' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly DeleteChat: WaAppstateSchema<'deleteChat', 'regular_high', 'chatMessageRange', 'deleteChatAction', readonly [{ readonly type: 'literal'; readonly value: 'deleteChat' }, { readonly type: 'wid'; readonly name: 'chatJid' }, { readonly type: 'string'; readonly name: 'key2' }]>
+    readonly DeleteMessageForMe: WaAppstateSchema<'deleteMessageForMe', 'regular_high', 'message', 'deleteMessageForMeAction', readonly [{ readonly type: 'literal'; readonly value: 'deleteMessageForMe' }, { readonly type: 'wid'; readonly name: 'remote' }, { readonly type: 'string'; readonly name: 'id' }, { readonly type: 'boolString'; readonly name: 'fromMe' }, { readonly type: 'jid'; readonly name: 'participant' }]>
+    readonly DetectedOutcomeStatus: WaAppstateSchema<'detected_outcomes_status_action', 'regular', 'account', 'map', readonly [{ readonly type: 'literal'; readonly value: 'detected_outcomes_status_action' }]>
+    readonly DeviceCapabilities: WaAppstateSchema<'device_capabilities', 'regular_low', 'account', 'deviceCapabilities', readonly [{ readonly type: 'literal'; readonly value: 'device_capabilities' }]>
+    readonly DisableLinkPreviews: WaAppstateSchema<'setting_disableLinkPreviews', 'regular', 'account', 'privacySettingDisableLinkPreviewsAction', readonly [{ readonly type: 'literal'; readonly value: 'setting_disableLinkPreviews' }]>
+    readonly ExternalWebBeta: WaAppstateSchema<'external_web_beta', 'regular', 'account', 'externalWebBetaAction', readonly [{ readonly type: 'literal'; readonly value: 'external_web_beta' }]>
+    readonly FavoriteSticker: WaAppstateSchema<'favoriteSticker', 'regular_low', 'account', 'stickerAction', readonly [{ readonly type: 'literal'; readonly value: 'favoriteSticker' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly Favorites: WaAppstateSchema<'favorites', 'regular_high', 'account', 'favoritesAction', readonly [{ readonly type: 'literal'; readonly value: 'favorites' }]>
+    readonly InteractiveMessageAction: WaAppstateSchema<'interactive_message_action', 'regular_low', 'message', 'interactiveMessageAction', readonly [{ readonly type: 'literal'; readonly value: 'interactive_message_action' }, { readonly type: 'wid'; readonly name: 'remote' }, { readonly type: 'string'; readonly name: 'id' }, { readonly type: 'boolString'; readonly name: 'fromMe' }, { readonly type: 'jid'; readonly name: 'participant' }, { readonly type: 'string'; readonly name: 'arg5' }]>
+    readonly LabelEdit: WaAppstateSchema<'label_edit', 'regular', 'account', 'labelEditAction', readonly [{ readonly type: 'literal'; readonly value: 'label_edit' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly LabelJid: WaAppstateSchema<'label_jid', 'regular', 'chatOrContact', 'labelAssociationAction', readonly [{ readonly type: 'literal'; readonly value: 'label_jid' }, { readonly type: 'string'; readonly name: 'key1' }, { readonly type: 'wid'; readonly name: 'chatJid' }]>
+    readonly LabelReordering: WaAppstateSchema<'label_reordering', 'regular', 'account', 'labelReorderingAction', readonly [{ readonly type: 'literal'; readonly value: 'label_reordering' }]>
+    readonly LidContact: WaAppstateSchema<'lid_contact', 'critical_unblock_low', 'account', 'lidContactAction', readonly [{ readonly type: 'literal'; readonly value: 'lid_contact' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly LocaleSetting: WaAppstateSchema<'setting_locale', 'critical_block', 'account', 'localeSetting', readonly [{ readonly type: 'literal'; readonly value: 'setting_locale' }]>
+    readonly LockChat: WaAppstateSchema<'lock', 'regular_low', 'chat', 'lockChatAction', readonly [{ readonly type: 'literal'; readonly value: 'lock' }, { readonly type: 'wid'; readonly name: 'chatJid' }]>
+    readonly MarkChatAsRead: WaAppstateSchema<'markChatAsRead', 'regular_low', 'chatMessageRange', 'markChatAsReadAction', readonly [{ readonly type: 'literal'; readonly value: 'markChatAsRead' }, { readonly type: 'wid'; readonly name: 'chatJid' }]>
+    readonly MarketingMessage: WaAppstateSchema<'marketingMessage', 'regular', 'account', 'marketingMessageAction', readonly [{ readonly type: 'literal'; readonly value: 'marketingMessage' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly MarketingMessageBroadcast: WaAppstateSchema<'marketingMessageBroadcast', 'regular', 'account', null, readonly [{ readonly type: 'literal'; readonly value: 'marketingMessageBroadcast' }, { readonly type: 'string'; readonly name: 'key1' }, { readonly type: 'string'; readonly name: 'key2' }]>
+    readonly MerchantPaymentPartner: WaAppstateSchema<'merchant_payment_partner', 'regular_low', 'account', 'merchantPaymentPartnerAction', readonly [{ readonly type: 'literal'; readonly value: 'merchant_payment_partner' }]>
+    readonly Mute: WaAppstateSchema<'mute', 'regular_high', 'chat', 'muteAction', readonly [{ readonly type: 'literal'; readonly value: 'mute' }, { readonly type: 'wid'; readonly name: 'chatJid' }]>
+    readonly NctSaltSync: WaAppstateSchema<'nct_salt_sync', 'regular_high', 'account', 'map', readonly [{ readonly type: 'literal'; readonly value: 'nct_salt_sync' }]>
+    readonly NoteEdit: WaAppstateSchema<'note_edit', 'regular_low', 'account', 'noteEditAction', readonly [{ readonly type: 'literal'; readonly value: 'note_edit' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly Nux: WaAppstateSchema<'nux', 'regular_low', 'account', 'nuxAction', readonly [{ readonly type: 'literal'; readonly value: 'nux' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly OutContact: WaAppstateSchema<'out_contact', 'regular_low', 'account', 'outContactAction', readonly [{ readonly type: 'literal'; readonly value: 'out_contact' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly PaymentInfo: WaAppstateSchema<'payment_info', 'regular_low', 'account', 'paymentInfoAction', readonly [{ readonly type: 'literal'; readonly value: 'payment_info' }]>
+    readonly PaymentTos: WaAppstateSchema<'payment_tos', 'regular_low', 'account', 'paymentTosAction', readonly [{ readonly type: 'literal'; readonly value: 'payment_tos' }]>
+    readonly Pin: WaAppstateSchema<'pin_v1', 'regular_low', 'chat', 'pinAction', readonly [{ readonly type: 'literal'; readonly value: 'pin_v1' }, { readonly type: 'wid'; readonly name: 'chatJid' }]>
+    readonly PnForLidChat: WaAppstateSchema<'pnForLidChat', 'regular', 'account', 'pnForLidChatAction', readonly [{ readonly type: 'literal'; readonly value: 'pnForLidChat' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly PrimaryFeature: WaAppstateSchema<'primary_feature', 'regular', 'account', 'primaryFeature', readonly [{ readonly type: 'literal'; readonly value: 'primary_feature' }]>
+    readonly PrimaryVersion: WaAppstateSchema<'primary_version', 'regular_low', 'account', 'primaryVersionAction', readonly [{ readonly type: 'literal'; readonly value: 'primary_version' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly QuickReply: WaAppstateSchema<'quick_reply', 'regular', 'account', 'quickReplyAction', readonly [{ readonly type: 'literal'; readonly value: 'quick_reply' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly RemoveRecentSticker: WaAppstateSchema<'removeRecentSticker', 'regular_low', 'account', 'removeRecentStickerAction', readonly [{ readonly type: 'literal'; readonly value: 'removeRecentSticker' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly Sentinel: WaAppstateSchema<'sentinel', 'regular_low', 'account', 'keyExpiration', readonly [{ readonly type: 'literal'; readonly value: 'sentinel' }]>
+    readonly SettingPushName: WaAppstateSchema<'setting_pushName', 'critical_block', 'account', 'pushNameSetting', readonly [{ readonly type: 'literal'; readonly value: 'setting_pushName' }]>
+    readonly SettingsSync: WaAppstateSchema<'settings_sync', 'regular_low', 'account', 'settingsSyncAction', readonly [{ readonly type: 'literal'; readonly value: 'settings_sync' }, { readonly type: 'string'; readonly name: 'key1' }, { readonly type: 'string'; readonly name: 'key2' }, { readonly type: 'wid'; readonly name: 'chatJid' }]>
+    readonly ShareOwnPn: WaAppstateSchema<'shareOwnPn', 'regular', 'account', null, readonly [{ readonly type: 'literal'; readonly value: 'shareOwnPn' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly Star: WaAppstateSchema<'star', 'regular_high', 'message', 'starAction', readonly [{ readonly type: 'literal'; readonly value: 'star' }, { readonly type: 'wid'; readonly name: 'remote' }, { readonly type: 'string'; readonly name: 'id' }, { readonly type: 'boolString'; readonly name: 'fromMe' }, { readonly type: 'jid'; readonly name: 'participant' }]>
+    readonly StatusPrivacy: WaAppstateSchema<'status_privacy', 'regular_high', 'account', 'statusPrivacy', readonly [{ readonly type: 'literal'; readonly value: 'status_privacy' }]>
+    readonly SubscriptionsSyncV2: WaAppstateSchema<'subscriptions_sync_v2', 'regular', 'account', 'subscriptionsSyncV2Action', readonly [{ readonly type: 'literal'; readonly value: 'subscriptions_sync_v2' }]>
+    readonly TimeFormat: WaAppstateSchema<'time_format', 'regular_low', 'account', 'timeFormatAction', readonly [{ readonly type: 'literal'; readonly value: 'time_format' }]>
+    readonly UnarchiveChatsSetting: WaAppstateSchema<'setting_unarchiveChats', 'regular_low', 'account', 'unarchiveChatsSetting', readonly [{ readonly type: 'literal'; readonly value: 'setting_unarchiveChats' }]>
+    readonly UserStatusMute: WaAppstateSchema<'userStatusMute', 'regular_high', 'account', 'userStatusMuteAction', readonly [{ readonly type: 'literal'; readonly value: 'userStatusMute' }, { readonly type: 'string'; readonly name: 'key1' }]>
+    readonly VoipRelayAllCalls: WaAppstateSchema<'setting_relayAllCalls', 'regular', 'account', 'privacySettingRelayAllCalls', readonly [{ readonly type: 'literal'; readonly value: 'setting_relayAllCalls' }]>
+    readonly WaffleAccountLinkState: WaAppstateSchema<'waffle_account_link_state', 'regular_high', 'account', 'waffleAccountLinkStateAction', readonly [{ readonly type: 'literal'; readonly value: 'waffle_account_link_state' }]>
+}
+
+export type WaAppstateActionKey = keyof typeof WA_APPSTATE_SCHEMAS
+
+// --- Derived helpers ------------------------------------------------------
+
+// Turn a schema's `indexParts` tuple into the runtime value tuple — what
+// you'd serialise on the wire. Literals are pinned to their constant value;
+// boolString slots widen to the wire-level 'true' | 'false' string.
+//
+//   WaAppstateIndexValueOf<typeof WA_APPSTATE_SCHEMAS.Mute>
+//     → readonly ['mute', string]
+//   WaAppstateIndexValueOf<typeof WA_APPSTATE_SCHEMAS.Star>
+//     → readonly ['star', string, string, 'true' | 'false', string]
+export type WaAppstateIndexValueOf<S> = S extends {
+    indexParts: infer P extends ReadonlyArray<WaAppstateIndexPart>
+}
+    ? {
+          readonly [K in keyof P]: P[K] extends { type: 'literal'; value: infer V }
+              ? V
+              : P[K] extends { type: 'boolString' }
+                ? 'true' | 'false'
+                : string
+      }
+    : never
+
+// Turn a schema's `indexParts` tuple into the keyword args object — what
+// a typed builder would accept. Literal slots are auto-filled by the
+// builder and dropped from the args; non-literals contribute their `name`.
+//
+//   WaAppstateIndexArgs<'Mute'>  → { readonly chatJid: string }
+//   WaAppstateIndexArgs<'Star'>  → {
+//       readonly remote: string
+//       readonly id: string
+//       readonly fromMe: boolean
+//       readonly participant: string
+//   }
+export type WaAppstateIndexArgs<K extends WaAppstateActionKey> = {
+    readonly [Part in (typeof WA_APPSTATE_SCHEMAS)[K]['indexParts'][number] as Part extends {
+        type: 'literal'
+    }
+        ? never
+        : Part extends { name: infer N extends string }
+          ? N
+          : never]: Part extends { type: 'boolString' } ? boolean : string
+}

package/index.js

@@ -0,0 +1,720 @@
+// AUTO-GENERATED — do not edit. Regenerated daily by wa-spec.
+// WhatsApp Version: 2.3000.1040072419
+'use strict'
+
+const WA_APPSTATE_COLLECTIONS = Object.freeze(['regular', 'regular_low', 'regular_high', 'critical_block', 'critical_unblock_low'])
+
+const WA_APPSTATE_SCHEMAS = Object.freeze({
+    AdsCtwaPerCustomerDataSharing: Object.freeze({
+        name: 'ctwaPerCustomerDataSharing',
+        collection: 'regular_high',
+        version: 1,
+        scope: 'account',
+        valueField: 'ctwaPerCustomerDataSharingAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'ctwaPerCustomerDataSharing' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    Agent: Object.freeze({
+        name: 'deviceAgent',
+        collection: 'regular',
+        version: 7,
+        scope: 'account',
+        valueField: 'agentAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'deviceAgent' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    AiThreadDelete: Object.freeze({
+        name: 'ai_thread_delete',
+        collection: 'regular_high',
+        version: 7,
+        scope: 'chat',
+        valueField: null,
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'ai_thread_delete' }),
+            Object.freeze({ type: 'wid', name: 'chatJid' }),
+            Object.freeze({ type: 'string', name: 'key2' })
+        ])
+    }),
+    AiThreadPin: Object.freeze({
+        name: 'thread_pin',
+        collection: 'regular_low',
+        version: 7,
+        scope: 'chat',
+        valueField: 'threadPinAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'thread_pin' }),
+            Object.freeze({ type: 'wid', name: 'chatJid' }),
+            Object.freeze({ type: 'string', name: 'key2' })
+        ])
+    }),
+    AiThreadRename: Object.freeze({
+        name: 'ai_thread_rename',
+        collection: 'regular_low',
+        version: 7,
+        scope: 'chat',
+        valueField: 'aiThreadRenameAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'ai_thread_rename' }),
+            Object.freeze({ type: 'wid', name: 'chatJid' }),
+            Object.freeze({ type: 'string', name: 'key2' })
+        ])
+    }),
+    AndroidUnsupportedActions: Object.freeze({
+        name: 'android_unsupported_actions',
+        collection: 'regular_low',
+        version: 4,
+        scope: 'account',
+        valueField: 'androidUnsupportedActions',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'android_unsupported_actions' })
+        ])
+    }),
+    Archive: Object.freeze({
+        name: 'archive',
+        collection: 'regular_low',
+        version: 3,
+        scope: 'chatMessageRange',
+        valueField: 'archiveChatAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'archive' }),
+            Object.freeze({ type: 'wid', name: 'chatJid' })
+        ])
+    }),
+    AvatarUpdated: Object.freeze({
+        name: 'avatar_updated_action',
+        collection: 'regular',
+        version: 7,
+        scope: 'account',
+        valueField: 'avatarUpdatedAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'avatar_updated_action' })
+        ])
+    }),
+    BizAiSettingsNudge: Object.freeze({
+        name: 'biz_ai_settings_nudge',
+        collection: 'regular_high',
+        version: 1,
+        scope: 'account',
+        valueField: 'bizAiSettingsNudgeAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'biz_ai_settings_nudge' })
+        ])
+    }),
+    BotWelcomeRequest: Object.freeze({
+        name: 'bot_welcome_request',
+        collection: 'regular_low',
+        version: 2,
+        scope: 'chat',
+        valueField: 'botWelcomeRequestAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'bot_welcome_request' }),
+            Object.freeze({ type: 'wid', name: 'chatJid' })
+        ])
+    }),
+    BusinessBroadcastCampaign: Object.freeze({
+        name: 'business_broadcast_campaign',
+        collection: 'regular',
+        version: 1,
+        scope: 'account',
+        valueField: 'businessBroadcastCampaignAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'business_broadcast_campaign' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    BusinessBroadcastInsights: Object.freeze({
+        name: 'business_broadcast_insights_sync',
+        collection: 'regular',
+        version: 1,
+        scope: 'account',
+        valueField: 'businessBroadcastInsightsAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'business_broadcast_insights_sync' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    BusinessBroadcastList: Object.freeze({
+        name: 'business_broadcast_list',
+        collection: 'regular',
+        version: 1,
+        scope: 'account',
+        valueField: 'businessBroadcastListAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'business_broadcast_list' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    CallLog: Object.freeze({
+        name: 'call_log',
+        collection: 'regular',
+        version: 1,
+        scope: 'account',
+        valueField: 'callLogAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'call_log' })
+        ])
+    }),
+    ChatAssignment: Object.freeze({
+        name: 'agentChatAssignment',
+        collection: 'regular',
+        version: 7,
+        scope: 'chat',
+        valueField: 'chatAssignment',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'agentChatAssignment' }),
+            Object.freeze({ type: 'wid', name: 'chatJid' })
+        ])
+    }),
+    ChatAssignmentOpenedStatus: Object.freeze({
+        name: 'agentChatAssignmentOpenedStatus',
+        collection: 'regular',
+        version: 7,
+        scope: 'chat',
+        valueField: 'chatAssignmentOpenedStatus',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'agentChatAssignmentOpenedStatus' }),
+            Object.freeze({ type: 'wid', name: 'chatJid' }),
+            Object.freeze({ type: 'string', name: 'key2' })
+        ])
+    }),
+    ChatLockSettings: Object.freeze({
+        name: 'setting_chatLock',
+        collection: 'regular_low',
+        version: 7,
+        scope: 'account',
+        valueField: 'chatLockSettings',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'setting_chatLock' })
+        ])
+    }),
+    ClearChat: Object.freeze({
+        name: 'clearChat',
+        collection: 'regular_high',
+        version: 6,
+        scope: 'chatMessageRange',
+        valueField: 'clearChatAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'clearChat' }),
+            Object.freeze({ type: 'wid', name: 'chatJid' }),
+            Object.freeze({ type: 'string', name: 'key2' }),
+            Object.freeze({ type: 'string', name: 'key3' })
+        ])
+    }),
+    Contact: Object.freeze({
+        name: 'contact',
+        collection: 'critical_unblock_low',
+        version: 2,
+        scope: 'account',
+        valueField: 'contactAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'contact' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    CustomPaymentMethods: Object.freeze({
+        name: 'custom_payment_methods',
+        collection: 'regular_low',
+        version: 7,
+        scope: 'account',
+        valueField: 'customPaymentMethodsAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'custom_payment_methods' })
+        ])
+    }),
+    CustomerData: Object.freeze({
+        name: 'customer_data',
+        collection: 'regular_low',
+        version: 1,
+        scope: 'account',
+        valueField: 'customerDataAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'customer_data' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    DeleteChat: Object.freeze({
+        name: 'deleteChat',
+        collection: 'regular_high',
+        version: 6,
+        scope: 'chatMessageRange',
+        valueField: 'deleteChatAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'deleteChat' }),
+            Object.freeze({ type: 'wid', name: 'chatJid' }),
+            Object.freeze({ type: 'string', name: 'key2' })
+        ])
+    }),
+    DeleteMessageForMe: Object.freeze({
+        name: 'deleteMessageForMe',
+        collection: 'regular_high',
+        version: 3,
+        scope: 'message',
+        valueField: 'deleteMessageForMeAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'deleteMessageForMe' }),
+            Object.freeze({ type: 'wid', name: 'remote' }),
+            Object.freeze({ type: 'string', name: 'id' }),
+            Object.freeze({ type: 'boolString', name: 'fromMe' }),
+            Object.freeze({ type: 'jid', name: 'participant' })
+        ])
+    }),
+    DetectedOutcomeStatus: Object.freeze({
+        name: 'detected_outcomes_status_action',
+        collection: 'regular',
+        version: 1,
+        scope: 'account',
+        valueField: 'map',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'detected_outcomes_status_action' })
+        ])
+    }),
+    DeviceCapabilities: Object.freeze({
+        name: 'device_capabilities',
+        collection: 'regular_low',
+        version: 7,
+        scope: 'account',
+        valueField: 'deviceCapabilities',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'device_capabilities' })
+        ])
+    }),
+    DisableLinkPreviews: Object.freeze({
+        name: 'setting_disableLinkPreviews',
+        collection: 'regular',
+        version: 8,
+        scope: 'account',
+        valueField: 'privacySettingDisableLinkPreviewsAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'setting_disableLinkPreviews' })
+        ])
+    }),
+    ExternalWebBeta: Object.freeze({
+        name: 'external_web_beta',
+        collection: 'regular',
+        version: 3,
+        scope: 'account',
+        valueField: 'externalWebBetaAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'external_web_beta' })
+        ])
+    }),
+    FavoriteSticker: Object.freeze({
+        name: 'favoriteSticker',
+        collection: 'regular_low',
+        version: 7,
+        scope: 'account',
+        valueField: 'stickerAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'favoriteSticker' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    Favorites: Object.freeze({
+        name: 'favorites',
+        collection: 'regular_high',
+        version: 1,
+        scope: 'account',
+        valueField: 'favoritesAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'favorites' })
+        ])
+    }),
+    InteractiveMessageAction: Object.freeze({
+        name: 'interactive_message_action',
+        collection: 'regular_low',
+        version: 1,
+        scope: 'message',
+        valueField: 'interactiveMessageAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'interactive_message_action' }),
+            Object.freeze({ type: 'wid', name: 'remote' }),
+            Object.freeze({ type: 'string', name: 'id' }),
+            Object.freeze({ type: 'boolString', name: 'fromMe' }),
+            Object.freeze({ type: 'jid', name: 'participant' }),
+            Object.freeze({ type: 'string', name: 'arg5' })
+        ])
+    }),
+    LabelEdit: Object.freeze({
+        name: 'label_edit',
+        collection: 'regular',
+        version: 3,
+        scope: 'account',
+        valueField: 'labelEditAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'label_edit' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    LabelJid: Object.freeze({
+        name: 'label_jid',
+        collection: 'regular',
+        version: 3,
+        scope: 'chatOrContact',
+        valueField: 'labelAssociationAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'label_jid' }),
+            Object.freeze({ type: 'string', name: 'key1' }),
+            Object.freeze({ type: 'wid', name: 'chatJid' })
+        ])
+    }),
+    LabelReordering: Object.freeze({
+        name: 'label_reordering',
+        collection: 'regular',
+        version: 3,
+        scope: 'account',
+        valueField: 'labelReorderingAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'label_reordering' })
+        ])
+    }),
+    LidContact: Object.freeze({
+        name: 'lid_contact',
+        collection: 'critical_unblock_low',
+        version: 1,
+        scope: 'account',
+        valueField: 'lidContactAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'lid_contact' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    LocaleSetting: Object.freeze({
+        name: 'setting_locale',
+        collection: 'critical_block',
+        version: 3,
+        scope: 'account',
+        valueField: 'localeSetting',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'setting_locale' })
+        ])
+    }),
+    LockChat: Object.freeze({
+        name: 'lock',
+        collection: 'regular_low',
+        version: 7,
+        scope: 'chat',
+        valueField: 'lockChatAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'lock' }),
+            Object.freeze({ type: 'wid', name: 'chatJid' })
+        ])
+    }),
+    MarkChatAsRead: Object.freeze({
+        name: 'markChatAsRead',
+        collection: 'regular_low',
+        version: 3,
+        scope: 'chatMessageRange',
+        valueField: 'markChatAsReadAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'markChatAsRead' }),
+            Object.freeze({ type: 'wid', name: 'chatJid' })
+        ])
+    }),
+    MarketingMessage: Object.freeze({
+        name: 'marketingMessage',
+        collection: 'regular',
+        version: 7,
+        scope: 'account',
+        valueField: 'marketingMessageAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'marketingMessage' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    MarketingMessageBroadcast: Object.freeze({
+        name: 'marketingMessageBroadcast',
+        collection: 'regular',
+        version: 7,
+        scope: 'account',
+        valueField: null,
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'marketingMessageBroadcast' }),
+            Object.freeze({ type: 'string', name: 'key1' }),
+            Object.freeze({ type: 'string', name: 'key2' })
+        ])
+    }),
+    MerchantPaymentPartner: Object.freeze({
+        name: 'merchant_payment_partner',
+        collection: 'regular_low',
+        version: 7,
+        scope: 'account',
+        valueField: 'merchantPaymentPartnerAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'merchant_payment_partner' })
+        ])
+    }),
+    Mute: Object.freeze({
+        name: 'mute',
+        collection: 'regular_high',
+        version: 2,
+        scope: 'chat',
+        valueField: 'muteAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'mute' }),
+            Object.freeze({ type: 'wid', name: 'chatJid' })
+        ])
+    }),
+    NctSaltSync: Object.freeze({
+        name: 'nct_salt_sync',
+        collection: 'regular_high',
+        version: 1,
+        scope: 'account',
+        valueField: 'map',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'nct_salt_sync' })
+        ])
+    }),
+    NoteEdit: Object.freeze({
+        name: 'note_edit',
+        collection: 'regular_low',
+        version: 7,
+        scope: 'account',
+        valueField: 'noteEditAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'note_edit' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    Nux: Object.freeze({
+        name: 'nux',
+        collection: 'regular_low',
+        version: 7,
+        scope: 'account',
+        valueField: 'nuxAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'nux' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    OutContact: Object.freeze({
+        name: 'out_contact',
+        collection: 'regular_low',
+        version: 1,
+        scope: 'account',
+        valueField: 'outContactAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'out_contact' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    PaymentInfo: Object.freeze({
+        name: 'payment_info',
+        collection: 'regular_low',
+        version: 7,
+        scope: 'account',
+        valueField: 'paymentInfoAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'payment_info' })
+        ])
+    }),
+    PaymentTos: Object.freeze({
+        name: 'payment_tos',
+        collection: 'regular_low',
+        version: 7,
+        scope: 'account',
+        valueField: 'paymentTosAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'payment_tos' })
+        ])
+    }),
+    Pin: Object.freeze({
+        name: 'pin_v1',
+        collection: 'regular_low',
+        version: 5,
+        scope: 'chat',
+        valueField: 'pinAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'pin_v1' }),
+            Object.freeze({ type: 'wid', name: 'chatJid' })
+        ])
+    }),
+    PnForLidChat: Object.freeze({
+        name: 'pnForLidChat',
+        collection: 'regular',
+        version: 8,
+        scope: 'account',
+        valueField: 'pnForLidChatAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'pnForLidChat' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    PrimaryFeature: Object.freeze({
+        name: 'primary_feature',
+        collection: 'regular',
+        version: 7,
+        scope: 'account',
+        valueField: 'primaryFeature',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'primary_feature' })
+        ])
+    }),
+    PrimaryVersion: Object.freeze({
+        name: 'primary_version',
+        collection: 'regular_low',
+        version: 7,
+        scope: 'account',
+        valueField: 'primaryVersionAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'primary_version' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    QuickReply: Object.freeze({
+        name: 'quick_reply',
+        collection: 'regular',
+        version: 2,
+        scope: 'account',
+        valueField: 'quickReplyAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'quick_reply' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    RemoveRecentSticker: Object.freeze({
+        name: 'removeRecentSticker',
+        collection: 'regular_low',
+        version: 7,
+        scope: 'account',
+        valueField: 'removeRecentStickerAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'removeRecentSticker' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    Sentinel: Object.freeze({
+        name: 'sentinel',
+        collection: 'regular_low',
+        version: 3,
+        scope: 'account',
+        valueField: 'keyExpiration',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'sentinel' })
+        ])
+    }),
+    SettingPushName: Object.freeze({
+        name: 'setting_pushName',
+        collection: 'critical_block',
+        version: 1,
+        scope: 'account',
+        valueField: 'pushNameSetting',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'setting_pushName' })
+        ])
+    }),
+    SettingsSync: Object.freeze({
+        name: 'settings_sync',
+        collection: 'regular_low',
+        version: 1,
+        scope: 'account',
+        valueField: 'settingsSyncAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'settings_sync' }),
+            Object.freeze({ type: 'string', name: 'key1' }),
+            Object.freeze({ type: 'string', name: 'key2' }),
+            Object.freeze({ type: 'wid', name: 'chatJid' })
+        ])
+    }),
+    ShareOwnPn: Object.freeze({
+        name: 'shareOwnPn',
+        collection: 'regular',
+        version: 8,
+        scope: 'account',
+        valueField: null,
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'shareOwnPn' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    Star: Object.freeze({
+        name: 'star',
+        collection: 'regular_high',
+        version: 2,
+        scope: 'message',
+        valueField: 'starAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'star' }),
+            Object.freeze({ type: 'wid', name: 'remote' }),
+            Object.freeze({ type: 'string', name: 'id' }),
+            Object.freeze({ type: 'boolString', name: 'fromMe' }),
+            Object.freeze({ type: 'jid', name: 'participant' })
+        ])
+    }),
+    StatusPrivacy: Object.freeze({
+        name: 'status_privacy',
+        collection: 'regular_high',
+        version: 7,
+        scope: 'account',
+        valueField: 'statusPrivacy',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'status_privacy' })
+        ])
+    }),
+    SubscriptionsSyncV2: Object.freeze({
+        name: 'subscriptions_sync_v2',
+        collection: 'regular',
+        version: 1,
+        scope: 'account',
+        valueField: 'subscriptionsSyncV2Action',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'subscriptions_sync_v2' })
+        ])
+    }),
+    TimeFormat: Object.freeze({
+        name: 'time_format',
+        collection: 'regular_low',
+        version: 7,
+        scope: 'account',
+        valueField: 'timeFormatAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'time_format' })
+        ])
+    }),
+    UnarchiveChatsSetting: Object.freeze({
+        name: 'setting_unarchiveChats',
+        collection: 'regular_low',
+        version: 4,
+        scope: 'account',
+        valueField: 'unarchiveChatsSetting',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'setting_unarchiveChats' })
+        ])
+    }),
+    UserStatusMute: Object.freeze({
+        name: 'userStatusMute',
+        collection: 'regular_high',
+        version: 7,
+        scope: 'account',
+        valueField: 'userStatusMuteAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'userStatusMute' }),
+            Object.freeze({ type: 'string', name: 'key1' })
+        ])
+    }),
+    VoipRelayAllCalls: Object.freeze({
+        name: 'setting_relayAllCalls',
+        collection: 'regular',
+        version: 1,
+        scope: 'account',
+        valueField: 'privacySettingRelayAllCalls',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'setting_relayAllCalls' })
+        ])
+    }),
+    WaffleAccountLinkState: Object.freeze({
+        name: 'waffle_account_link_state',
+        collection: 'regular_high',
+        version: 1,
+        scope: 'account',
+        valueField: 'waffleAccountLinkStateAction',
+        indexParts: Object.freeze([
+            Object.freeze({ type: 'literal', value: 'waffle_account_link_state' })
+        ])
+    })
+})
+
+module.exports = { WA_APPSTATE_COLLECTIONS, WA_APPSTATE_SCHEMAS }

package/package.json

@@ -0,0 +1,51 @@
+{
+    "name": "@vinikjkkj/wa-appstate",
+    "version": "0.1.0",
+    "description": "WhatsApp Web AppState (Syncd) action schemas — wire names, collections, versions, value fields, index shapes (daily-extracted).",
+    "keywords": [
+        "whatsapp",
+        "whatsapp-web",
+        "appstate",
+        "syncd",
+        "sync-action",
+        "multi-device",
+        "wa-spec"
+    ],
+    "license": "MIT",
+    "author": {
+        "name": "vinikjkkj",
+        "url": "https://github.com/vinikjkkj"
+    },
+    "homepage": "https://github.com/vinikjkkj/wa-spec/tree/main/packages/appstate#readme",
+    "bugs": {
+        "url": "https://github.com/vinikjkkj/wa-spec/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/vinikjkkj/wa-spec.git",
+        "directory": "packages/appstate"
+    },
+    "funding": [
+        {
+            "type": "github",
+            "url": "https://github.com/sponsors/vinikjkkj"
+        }
+    ],
+    "main": "index.js",
+    "types": "index.d.ts",
+    "sideEffects": false,
+    "files": [
+        "index.js",
+        "index.d.ts",
+        "README.md"
+    ],
+    "scripts": {
+        "apply": "node ./scripts/apply.cjs"
+    },
+    "engines": {
+        "node": ">=20.9.0"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
+}