vite-plugin-taro 0.3.1 → 0.4.0

package/src/runtime/wx/react-refresh.d.ts

@@ -1,20 +0,0 @@
-/** Vite's development-only React Refresh virtual module used by the WX runtime. */
-declare module '*/@react-refresh' {
-    export type RefreshResult = {
-        updatedFamilies: Set<unknown>
-        staleFamilies: Set<unknown>
-    }
-
-    export function register(type: unknown, id: string): void
-    export function registerExportsForReactRefresh(filename: string, moduleExports: Record<string, unknown>): void
-    export function validateRefreshBoundaryAndEnqueueUpdate(
-        id: string,
-        previousExports: Record<string, unknown>,
-        nextExports: Record<string, unknown>
-    ): string | undefined
-
-    const runtime: {
-        injectIntoGlobalHook(globalObject: typeof globalThis): void
-    }
-    export default runtime
-}

package/src/runtime/wx/taro-runtime.ts

@@ -1,7 +0,0 @@
-/** Runtime exports consumed by generated WX App, page, and recursive-component entries. */
-import '@tarojs/plugin-platform-weapp/dist/runtime.js'
-
-// @ts-expect-error Taro exposes createReactApp from this runtime-only deep entry without types.
-export { createReactApp } from '@tarojs/plugin-framework-react/dist/runtime'
-export { default as ReactDOM } from '@tarojs/react'
-export { createPageConfig, createRecursiveComponentConfig } from '@tarojs/runtime'

package/src/runtime/wx/update-client-state.ts

@@ -1,138 +0,0 @@
-/**
- * Pure App-side stop-and-wait protocol state machine.
- *
- * It knows build versions and sequencing only; wx.request, literal code execution, and page lifecycle effects live in
- * update-client.ts and page-update.ts.
- */
-type WxUpdateClientPhase = 'stopped' | 'registering' | 'polling' | 'applying' | 'refreshing' | 'relaunching'
-
-type WxUpdateClientState = {
-    buildId: string
-    version: number
-    phase: WxUpdateClientPhase
-    targetVersion?: number
-    pendingBatch?: { fromVersion: number; targetVersion: number }
-}
-
-export type WxUpdateClientEvent =
-    | { type: 'started' }
-    | { type: 'registration-completed' }
-    | { type: 'poll-completed' }
-    | { type: 'batch-observed'; buildId: string; fromVersion: number; targetVersion: number }
-    | { type: 'batch-executed'; targetVersion: number }
-    | { type: 'batch-failed' }
-    | { type: 'refresh-completed'; stale: boolean }
-    | { type: 'route-ready' }
-    | { type: 'transport-failed' }
-
-export type WxUpdateClientCommand =
-    | { type: 'register'; version: number }
-    | { type: 'poll'; version: number }
-    | { type: 'apply-batch'; fromVersion: number; targetVersion: number }
-    | { type: 'report-version'; version: number; reason: 'applied' | 'batch-mismatch' }
-    | { type: 'request-full-build'; reason: 'batch-execution-failed' }
-    | { type: 'retry-transport' }
-
-type WxUpdateClientTransition = {
-    state: WxUpdateClientState
-    commands: WxUpdateClientCommand[]
-}
-
-export function createWxUpdateClientState(buildId: string): WxUpdateClientState {
-    return { buildId, version: 0, phase: 'stopped' }
-}
-
-export function transitionWxUpdateClient(
-    state: WxUpdateClientState,
-    event: WxUpdateClientEvent
-): WxUpdateClientTransition {
-    switch (event.type) {
-        case 'started':
-            if (state.phase !== 'stopped') return transition(state)
-            return command({ ...state, phase: 'registering' }, { type: 'register', version: state.version })
-        case 'registration-completed': {
-            if (state.phase !== 'registering') return transition(state)
-            const pending = state.pendingBatch
-            if (!pending) return command({ ...state, phase: 'polling' }, { type: 'poll', version: state.version })
-            return command(
-                { ...state, phase: 'applying', targetVersion: pending.targetVersion, pendingBatch: undefined },
-                { type: 'apply-batch', ...pending }
-            )
-        }
-        case 'poll-completed':
-            if (state.phase !== 'polling') return transition(state)
-            return command(state, { type: 'poll', version: state.version })
-        case 'batch-observed':
-            return observeBatch(state, event)
-        case 'batch-executed':
-            if (state.phase !== 'applying' || state.targetVersion !== event.targetVersion) {
-                return command(state, { type: 'report-version', version: state.version, reason: 'batch-mismatch' })
-            }
-            return transition({ ...state, phase: 'refreshing', version: event.targetVersion })
-        case 'batch-failed':
-            return command(
-                { ...state, phase: 'polling', targetVersion: undefined },
-                { type: 'request-full-build', reason: 'batch-execution-failed' }
-            )
-        case 'refresh-completed':
-            if (state.phase !== 'refreshing') return transition(state)
-            if (event.stale) return transition({ ...state, phase: 'relaunching' })
-            return applied(state)
-        case 'route-ready':
-            if (state.phase !== 'relaunching') return transition(state)
-            return applied(state)
-        case 'transport-failed':
-            return command(state, { type: 'retry-transport' })
-    }
-}
-
-function observeBatch(
-    state: WxUpdateClientState,
-    batch: { buildId: string; fromVersion: number; targetVersion: number }
-): WxUpdateClientTransition {
-    const valid =
-        batch.buildId === state.buildId &&
-        Number.isInteger(batch.fromVersion) &&
-        Number.isInteger(batch.targetVersion) &&
-        batch.fromVersion >= 0 &&
-        batch.targetVersion > batch.fromVersion
-    if (state.phase === 'registering') {
-        if (!valid || batch.fromVersion !== state.version || batch.targetVersion <= state.version) {
-            return transition(state)
-        }
-        return transition({
-            ...state,
-            pendingBatch: { fromVersion: batch.fromVersion, targetVersion: batch.targetVersion }
-        })
-    }
-    if (!valid) {
-        return command(state, { type: 'report-version', version: state.version, reason: 'batch-mismatch' })
-    }
-    if (batch.targetVersion <= state.version) {
-        return command(state, { type: 'report-version', version: state.version, reason: 'applied' })
-    }
-    if (state.phase !== 'polling' || batch.fromVersion !== state.version) {
-        return command(state, { type: 'report-version', version: state.version, reason: 'batch-mismatch' })
-    }
-    return command(
-        { ...state, phase: 'applying', targetVersion: batch.targetVersion },
-        {
-            type: 'apply-batch',
-            fromVersion: batch.fromVersion,
-            targetVersion: batch.targetVersion
-        }
-    )
-}
-
-function applied(state: WxUpdateClientState): WxUpdateClientTransition {
-    const appliedState = { ...state, phase: 'polling' as const, targetVersion: undefined }
-    return command(appliedState, { type: 'report-version', version: state.version, reason: 'applied' })
-}
-
-function transition(state: WxUpdateClientState): WxUpdateClientTransition {
-    return { state, commands: [] }
-}
-
-function command(state: WxUpdateClientState, value: WxUpdateClientCommand): WxUpdateClientTransition {
-    return { state, commands: [value] }
-}

package/src/runtime/wx/update-client.ts

@@ -1,222 +0,0 @@
-/**
- * App-owned adapter for the WX update protocol.
- *
- * It transports metadata with wx.request and executes literal batches delivered through update.js. React/Taro page
- * preservation is delegated to page-update.ts so the App never depends on the mutable update file.
- */
-import {
-    createWxUpdateClientState,
-    transitionWxUpdateClient,
-    type WxUpdateClientCommand,
-    type WxUpdateClientEvent
-} from './update-client-state.ts'
-
-type WxUpdateControl = {
-    url: string
-    token: string
-    buildId: string
-}
-
-type WxUpdateBatchMetadata = {
-    buildId: string
-    fromVersion: number
-    targetVersion: number
-}
-
-type WxRequestTask = {
-    abort(): void
-}
-
-type WxRequestResult = {
-    data?: unknown
-}
-
-type WxPageUpdateCoordinator = {
-    ready: boolean
-    pendingUpdate?: () => void
-    beginUpdate?: () => void
-    endUpdate?: () => void
-}
-
-type WxUpdateClient = {
-    receiveBatch(metadata: WxUpdateBatchMetadata, apply: () => void): void
-    refreshCompleted(stale: boolean): void
-    routeReady(): void
-}
-
-type WxClientGlobal = typeof globalThis & {
-    __VITE_PLUGIN_TARO_WX_CONTROL__?: WxUpdateControl
-    __VITE_PLUGIN_TARO_WX_UPDATE_CLIENT__?: WxUpdateClient
-    __VITE_PLUGIN_TARO_WX_PAGE_UPDATE__?: WxPageUpdateCoordinator
-    wx: {
-        request(options: {
-            url: string
-            method: 'POST'
-            data: unknown
-            timeout: number
-            success(result: WxRequestResult): void
-            fail(error: { errMsg?: string }): void
-        }): WxRequestTask
-    }
-}
-
-const wxClientGlobal = globalThis as WxClientGlobal
-const transportRetryDelay = 500
-const rebuildPollDelay = 1_000
-const updateFileWatchdogDelay = 2_000
-
-export function startWxUpdateClient(): void {
-    if (wxClientGlobal.__VITE_PLUGIN_TARO_WX_UPDATE_CLIENT__) return
-    const control = wxClientGlobal.__VITE_PLUGIN_TARO_WX_CONTROL__
-    if (!control) throw new Error('vite-plugin-taro could not find its WX update control configuration.')
-
-    let state = createWxUpdateClientState(control.buildId)
-    const sessionId = createSessionId()
-    let requestGeneration = 0
-    let activeRequest: WxRequestTask | undefined
-    let scheduledRequest: ReturnType<typeof setTimeout> | undefined
-    let pendingBatchApply: (() => void) | undefined
-
-    const dispatch = (event: WxUpdateClientEvent, apply?: () => void): void => {
-        const transition = transitionWxUpdateClient(state, event)
-        state = transition.state
-        for (const command of transition.commands) execute(command, apply)
-    }
-
-    const send = (action: 'register' | 'poll' | 'rebuild', version: number): void => {
-        if (scheduledRequest) clearTimeout(scheduledRequest)
-        scheduledRequest = undefined
-        activeRequest?.abort()
-        const generation = ++requestGeneration
-        activeRequest = wxClientGlobal.wx.request({
-            url: control.url,
-            method: 'POST',
-            data: {
-                token: control.token,
-                action,
-                buildId: state.buildId,
-                sessionId,
-                version
-            },
-            timeout: 30_000,
-            success(result) {
-                if (generation !== requestGeneration) return
-                activeRequest = undefined
-                const response = parseResponse(result.data)
-                if (action === 'register' && response.type === 'registered') {
-                    dispatch({ type: 'registration-completed' })
-                    return
-                }
-                if (action === 'poll' && (response.type === 'idle' || response.type === 'changed')) {
-                    dispatch({ type: 'poll-completed' })
-                    return
-                }
-                if (response.type === 'batch-published') {
-                    // If DevTools misses the update.js event, report the unchanged version and republish with a new nonce.
-                    scheduleRequest(updateFileWatchdogDelay)
-                    return
-                }
-                if (response.type === 'rebuilding') {
-                    scheduleRequest(rebuildPollDelay)
-                    return
-                }
-                dispatch({ type: 'transport-failed' })
-            },
-            fail() {
-                if (generation !== requestGeneration) return
-                activeRequest = undefined
-                dispatch({ type: 'transport-failed' })
-            }
-        })
-    }
-
-    /** Keeps exactly one delayed metadata request and discards it when protocol state advances. */
-    const scheduleRequest = (delay: number): void => {
-        if (scheduledRequest) clearTimeout(scheduledRequest)
-        const expectedPhase = state.phase
-        const expectedVersion = state.version
-        scheduledRequest = setTimeout(() => {
-            scheduledRequest = undefined
-            if (state.phase !== expectedPhase || state.version !== expectedVersion) return
-            send(state.phase === 'registering' ? 'register' : 'poll', state.version)
-        }, delay)
-    }
-
-    const execute = (command: WxUpdateClientCommand, apply?: () => void): void => {
-        switch (command.type) {
-            case 'register':
-                send('register', command.version)
-                return
-            case 'poll':
-            case 'report-version':
-                send('poll', command.version)
-                return
-            case 'apply-batch': {
-                const batchApply = apply ?? pendingBatchApply
-                pendingBatchApply = undefined
-                if (!batchApply) {
-                    dispatch({ type: 'batch-failed' })
-                    return
-                }
-                const applyUpdate = () => {
-                    const bridge = wxClientGlobal.__VITE_PLUGIN_TARO_WX_PAGE_UPDATE__
-                    if (!bridge) {
-                        dispatch({ type: 'batch-failed' })
-                        return
-                    }
-                    bridge.beginUpdate?.()
-                    try {
-                        batchApply()
-                        dispatch({ type: 'batch-executed', targetVersion: command.targetVersion })
-                    } catch {
-                        dispatch({ type: 'batch-failed' })
-                    } finally {
-                        bridge.endUpdate?.()
-                    }
-                }
-                const bridge = wxClientGlobal.__VITE_PLUGIN_TARO_WX_PAGE_UPDATE__
-                if (bridge?.ready) applyUpdate()
-                else if (bridge) bridge.pendingUpdate = applyUpdate
-                else dispatch({ type: 'batch-failed' })
-                return
-            }
-            case 'request-full-build':
-                send('rebuild', state.version)
-                return
-            case 'retry-transport':
-                scheduleRequest(transportRetryDelay)
-        }
-    }
-
-    wxClientGlobal.__VITE_PLUGIN_TARO_WX_UPDATE_CLIENT__ = {
-        receiveBatch(metadata, apply) {
-            dispatch({ type: 'batch-observed', ...metadata }, apply)
-            if (
-                state.pendingBatch?.fromVersion === metadata.fromVersion &&
-                state.pendingBatch.targetVersion === metadata.targetVersion
-            ) {
-                pendingBatchApply = apply
-            } else if (!state.pendingBatch && state.phase !== 'applying') {
-                pendingBatchApply = undefined
-            }
-        },
-        refreshCompleted(stale) {
-            dispatch({ type: 'refresh-completed', stale })
-        },
-        routeReady() {
-            dispatch({ type: 'route-ready' })
-        }
-    }
-    dispatch({ type: 'started' })
-}
-
-function createSessionId(): string {
-    return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`
-}
-
-function parseResponse(value: unknown): { type: string } {
-    if (typeof value !== 'object' || value === null || !('type' in value) || typeof value.type !== 'string') {
-        return { type: 'invalid' }
-    }
-    return { type: value.type }
-}