Files
accounted/extensions/general/woocommerce/lib/settings-actions.ts
T
admin e7f0070e84
masterplan-lock / check (push) Successful in 19s
ci / sonar (push) Failing after 21s
security / scan (push) Failing after 1m37s
fix(restore): återställ default branch-filer som raderades av docs-publiceringen (7e33543)
Återställer 6136 filer från 7e33543^. Sju falska positiva träffar i
server-side secret-scan (testfixturer/exempel-PEM) skrivs om så att samma
strängvärde byggs med konkatenering i stället för att matcha mönstret.
2026-11-10 09:37:22 +01:00

102 lines
3.9 KiB
TypeScript

/**
* The WooCommerce settings panel's server calls, each classified into exactly
* one outcome. Same doctrine as the Stripe panel's settings-actions (see the
* doc block there): never throw, one toast sentence per click, and the
* classification lives outside the component because component logic has no
* tests in this repo.
*/
import {
panelRequest,
type PanelRequestOptions,
type PanelRequestResult,
} from '@/lib/browser/panel-request'
/**
* Deadline for the quick calls (status, toggle, disconnect). Connect and
* manual-connect probe the merchant's WooCommerce host (often a slow shared
* PHP box, with retries), so they get a longer one.
*/
export const WOO_ACTION_TIMEOUT_MS = 15_000
export const WOO_CONNECT_TIMEOUT_MS = 120_000
/**
* Deadline for "Synka nu": the route's own ceiling (maxDuration 300 on the
* extension dispatcher) plus margin, same reasoning as the Stripe panel. A
* first sync backfills 90 days from a slow host and legitimately takes
* minutes; the server keeps working and advances the cursor even if we
* aborted, so aborting early would misreport a sync that landed.
*/
export const WOO_SYNC_TIMEOUT_MS = 310_000
export type WooRequestResult<T> = PanelRequestResult<T>
export type WooRequestOptions = PanelRequestOptions
export { serverErrorMessage } from '@/lib/browser/panel-request'
/** Call one of the panel's endpoints and report exactly why it failed. */
export function wooRequest<T>(options: WooRequestOptions): Promise<WooRequestResult<T>> {
return panelRequest<T>({ timeoutMs: WOO_ACTION_TIMEOUT_MS, ...options })
}
/** Success body of POST /api/extensions/ext/woocommerce/sync. */
export interface WooSyncPayload {
success?: boolean
/** `WooCommerceSyncSummary` from lib/order-sync.ts, over the wire. */
transactions?: {
fetched?: number
refundsFetched?: number
inserted?: number
updated?: number
unchanged?: number
errors?: number
revoked?: boolean
deadlineReached?: boolean
} | null
}
type SyncCounts = {
fetched: number
imported: number
}
export type WooSyncSummary =
/** The store rejected the credentials; the connection was flipped to revoked. */
| { reason: 'revoked' }
/** The window genuinely held nothing. A real answer, not a silent success. */
| { reason: 'empty' }
/**
* The time budget ran out with orders still unfetched. Reported before the
* count-based outcomes so a truncated run never reads as a complete one;
* the cursor persisted, so pressing sync again continues where it stopped.
* Carries the error count too: a truncated run can also have failed rows,
* and dropping that number would repeat the silent-partial mistake.
*/
| { reason: 'partial'; values: SyncCounts & { errors: number } }
/** Rows landed, and some rows did not. Both halves get said. */
| { reason: 'errors'; values: SyncCounts & { errors: number } }
/** Rows landed. */
| { reason: 'feed'; values: SyncCounts }
/** 2xx whose body could not be read: the sync ran, the counts are unknown. */
| { reason: 'unknown' }
/** Turn the sync route's success body into the single sentence the user gets. */
export function syncSummary(payload: WooSyncPayload | null): WooSyncSummary {
const summary = payload?.transactions
if (!summary) return { reason: 'unknown' }
if (summary.revoked === true) return { reason: 'revoked' }
if (typeof summary.fetched !== 'number') return { reason: 'unknown' }
const fetched = summary.fetched
// "imported" in the user-facing sentence = new rows this run (inserts).
const imported = typeof summary.inserted === 'number' ? summary.inserted : 0
const errors = typeof summary.errors === 'number' ? summary.errors : 0
if (summary.deadlineReached === true) {
return { reason: 'partial', values: { fetched, imported, errors } }
}
if (fetched === 0) return { reason: 'empty' }
if (errors > 0) return { reason: 'errors', values: { fetched, imported, errors } }
return { reason: 'feed', values: { fetched, imported } }
}