Files
accounted/lib/pending-operations/skatteverket-commit.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.5 KiB
TypeScript

/**
* Core ↔ Skatteverket-extension commit boundary.
*
* `lib/` cannot import from `@/extensions/` (CI guard, core-build.yml), so the
* commit-side executors reach the Skatteverket extension only through the
* registry-resolved `services` channel. This module defines the SHARED shape
* the extension's commit services return and the recoverable-error class the
* dispatcher uses to release an op back to `pending`: both live in core so the
* extension (which may import core freely) and `commit.ts` agree on the
* contract without core ever importing the extension.
*/
import type { SkattekontoBatchResult } from '@/types/skatteverket'
/** Result returned by the extension's commitSubmitVatDeclaration / commitSubmitAgi. */
export type SkvSubmitResult =
| ({
ok: true
/** BankID signing deep-link. The op is "sent for signing", not filed. */
signing_url: string
} & Record<string, unknown>)
| {
ok: false
/** Structured error code (see lib/errors/structured-errors.ts). */
code: string
http_status: number
/**
* true → the op is fine; the connection/flag/quota isn't. Release it back
* to `pending` so the user can fix and re-approve the SAME op.
* false → a wrong-data / SKV-business condition. Reject (consume) the op;
* the user must regenerate and re-stage.
*/
recoverable: boolean
error: string
}
/** The two functions a fully-wired skatteverket extension exposes on `services`. */
export interface SkatteverketCommitServices {
commitSubmitVatDeclaration: (
supabase: unknown,
userId: string,
companyId: string,
params: Record<string, unknown>,
) => Promise<SkvSubmitResult>
commitSubmitAgi: (
supabase: unknown,
userId: string,
companyId: string,
params: Record<string, unknown>,
) => Promise<SkvSubmitResult>
}
/**
* Result returned by the extension's commitBookSkattekontoRows service.
* On ok the shape is the same per-row list + summary the HTTP bokfor-batch
* endpoint returns (types/skatteverket.ts): row failures are data, never a
* thrown error, so a partially successful batch still commits the op with
* the failed rows listed in result_data.
*/
export type SkattekontoBookCommitResult =
| ({ ok: true } & SkattekontoBatchResult)
| {
ok: false
code: string
http_status: number
/** Same semantics as SkvSubmitResult: true releases the op back to pending. */
recoverable: boolean
error: string
}
/**
* Booking service a fully-wired skatteverket extension exposes on `services`.
* Separate from SkatteverketCommitServices so the skattekonto booking path
* (local bookkeeping over already-synced rows) does not depend on the SKV
* filing services being wired, and vice versa.
*/
export interface SkattekontoBookingCommitService {
commitBookSkattekontoRows: (
supabase: unknown,
userId: string,
companyId: string,
params: Record<string, unknown>,
) => Promise<SkattekontoBookCommitResult>
}
/**
* Thrown by a commit executor when the failure is recoverable (extension
* disabled, no SKV connection, rate-limited). The dispatcher catches it,
* releases the atomic claim back to `pending`, and surfaces { error, code,
* http_status }: mirroring the AccountsNotInChartError release path.
*/
export class SkatteverketRecoverableError extends Error {
constructor(
message: string,
public readonly code: string,
public readonly httpStatus: number,
) {
super(message)
this.name = 'SkatteverketRecoverableError'
}
}