@innspel/core 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,579 @@
+/**
+ * Opak koblingsnøkkel til et maskinsignal hos leietakeren (krasj-ID, sesjons-ID, avspillings-ID). Plattformen validerer at kind er deklarert og at value matcher kind-ens pattern, og tolker eller følger aldri verdien (DD-43).
+ */
+type CommonCorrelation = {
+    /**
+     * Deklarert av leietakeren i innstillingene. «crash» er forhåndsdefinert.
+     */
+    kind: string;
+    value: string;
+};
+/**
+ * Maskinlesbar feilkode. Klienten forgrener på denne, aldri på message. Meldingen navngir feltet som feilet, aldri innsendte verdier — den kan inneholde fritekst fra innsenderen.
+ */
+type CommonErrorCode = 'validation_failed' | 'unknown_field' | 'text_too_short' | 'text_too_long' | 'correlation_invalid' | 'unauthenticated' | 'feedback_token_required' | 'feedback_token_invalid' | 'feedback_token_expired' | 'mfa_required' | 'insufficient_role' | 'insufficient_scope' | 'screenshots_disabled' | 'submission_not_found' | 'known_issue_not_found' | 'program_not_found' | 'invitation_invalid' | 'task_not_found' | 'follow_up_not_found' | 'participant_not_found' | 'subject_not_found' | 'attachment_not_found' | 'webhook_not_found' | 'delivery_not_found' | 'product_not_found' | 'key_not_found' | 'receipt_not_found' | 'report_not_found' | 'handoff_invalid' | 'invalid_status_transition' | 'reply_exists' | 'invitation_already_answered' | 'program_incomplete' | 'program_full' | 'task_already_completed' | 'follow_up_already_answered' | 'report_frozen' | 'webhook_not_verified' | 'attachment_already_uploaded' | 'reply_required' | 'reason_code_required' | 'template_unmodified' | 'fixed_in_required' | 'canonical_is_duplicate' | 'known_issue_conflict' | 'deadline_cannot_be_extended' | 'minors_present_conflict' | 'contacts_exceed_tenant_cap' | 'data_limitations_required' | 'attachment_too_large' | 'attachment_type_not_allowed' | 'rate_limited' | 'not_implemented';
+/**
+ * Plattformen innsendingen kom fra. Lukket liste fra dag én, inkludert storskjerm — en verdi som legges til senere er en kontraktendring hos alle SDK-er (ideer/storskjerm-qr-handoff.md).
+ */
+type CommonPlatform = 'ios' | 'android' | 'web' | 'tvos' | 'androidtv' | 'tizen' | 'webos';
+/**
+ * Kjent feil-kortet slik SDK-et og portalen viser det, FØR innsending i feilsporet (differensiatoren, M2.4). Tre deler: hva, omvei, gjelder versjon (DD-30). Tre svar i klienten: «Ja, jeg også» (KnownIssues.confirm) · «Ligner, men ikke helt» (relatedKnownIssueId på innsendingen) · «Nei, det er noe annet» (vanlig innsending) (DD-29). Aldri Reach — innsenderen ser ikke hvor mange andre.
+ */
+type KnownIssuesKnownIssueCard = {
+    id: string;
+    /**
+     * I brukerens ord, 1–3 setninger.
+     */
+    title: string;
+    /**
+     * Valgfri omvei, 1–3 setninger.
+     */
+    workaround?: string;
+    status: KnownIssuesKnownIssueStatus;
+    /**
+     * Versjonen feilen rettes eller er rettet i. Vises som «Rettes i X» når aktiv, «Rettet i X» når fikset.
+     */
+    fixedIn?: string;
+};
+/**
+ * aktiv vises i skjemaet (DD-03); fikset krever fixedIn og utløser Rettet-varselet til alle med Reach (DD-31). Kortet vises for fikset så lenge innsenderens appVersion ≤ fixedIn, og skjules for nyere (DD-30).
+ */
+type KnownIssuesKnownIssueStatus = 'aktiv' | 'fikset';
+/**
+ * paaminnelse bærer alltid fristen i teksten; tilbud_om_utgang er eneste lovlige form for den betingede kontakten når ingen oppgave er gjort (DD-34).
+ */
+type ProgramsFollowUpKind = 'paaminnelse' | 'hvordan_gikk_det' | 'sjekkpunkt' | 'tilbud_om_utgang';
+/**
+ * En oppfølging som er sendt ut til kalleren og ikke besvart. Teksten bærer fristen når kind = paaminnelse (DD-34).
+ */
+type ProgramsFollowUpView = {
+    id: string;
+    programId: string;
+    kind: ProgramsFollowUpKind;
+    question: string;
+    deadlineAt?: string;
+    emittedAt: string;
+};
+/**
+ * utloept er utledet av klokka, aldri skrevet.
+ */
+type ProgramsInvitationStatus = 'sendt' | 'akseptert' | 'avslaatt' | 'utloept';
+/**
+ * Invitasjon rettet til kallerens subject. Tokenet finnes ikke her — det kom via leietakerens kanal (DD-12); listen viser at invitasjonen finnes så banneret kan tegnes.
+ */
+type ProgramsInvitationView = {
+    id: string;
+    program: ProgramsProgramView;
+    status: ProgramsInvitationStatus;
+    expiresAt: string;
+};
+/**
+ * Alt om betaprogram for kallerens subject i ett kall — SDK-ets programs.list(). Krever feedback-token; anonym modus har ingen programmer.
+ */
+type ProgramsMyPrograms = {
+    invitations: Array<ProgramsInvitationView>;
+    participations: Array<ProgramsParticipationView>;
+    pendingFollowUps: Array<ProgramsFollowUpView>;
+};
+/**
+ * trukket: deltakeren gikk ut selv («Gå ut» er alltid synlig, DD-36). Ut av segmentet umiddelbart.
+ */
+type ProgramsParticipantStatus = 'aktiv' | 'fullfoert' | 'trukket';
+/**
+ * Kallerens egen deltakelse med oppgavestatus. contactsSent / maxContacts vises i fanen.
+ */
+type ProgramsParticipationView = {
+    id: string;
+    program: ProgramsProgramView;
+    status: ProgramsParticipantStatus;
+    joinedAt: string;
+    completions: Array<ProgramsTaskCompletionView>;
+    contactsSent: number;
+};
+/**
+ * Programmet slik testeren ser det i aksepten (DD-13, DD-32) og i fanen. Ingen andre deltakere, ingen tall om andre.
+ */
+type ProgramsProgramView = {
+    id: string;
+    name: string;
+    /**
+     * Hva som testes — vises først i aksepten.
+     */
+    hypothesis: string;
+    opensAt: string;
+    closesAt: string;
+    /**
+     * Maks antall kontakter testeren kan få. Vises ved aksept; plattformen nekter å sende flere (DD-14).
+     */
+    maxContacts: number;
+    /**
+     * Forpliktelsesfri form: ingen insentiv, ingen frist, ingen vilkår. Tvunget ved minorsPresent (K37).
+     */
+    commitmentFree: boolean;
+    /**
+     * Leietakerens vilkår som lenke — aldri avkryssing som binder (DD-37). Alltid null ved commitmentFree.
+     */
+    termsUrl?: string;
+    tasks: Array<ProgramsTask>;
+    /**
+     * Kjente feil merket visibleToTesters, vist i aksepten (hele lista, DD-13) med samme kort som widgeten.
+     */
+    knownIssues: Array<KnownIssuesKnownIssueCard>;
+};
+/**
+ * Én oppgave i programmet. estimatedMinutes er obligatorisk — aksepten viser «N oppgaver × M minutter» (DD-32).
+ */
+type ProgramsTask = {
+    id: string;
+    /**
+     * Rekkefølge fra 1. Oppgave 1 foreslås som «Send ditt første innspill» (DD-33).
+     */
+    order: number;
+    title: string;
+    instruction: string;
+    /**
+     * Skjermen oppgaven gjelder — hint til testeren, aldri en dyplenke plattformen følger.
+     */
+    screenHint?: string;
+    estimatedMinutes: number;
+};
+/**
+ * Én fullført oppgave, som testeren ser den.
+ */
+type ProgramsTaskCompletionView = {
+    taskId: string;
+    outcome: ProgramsTaskOutcome;
+    at: string;
+    submissionId?: string;
+};
+/**
+ * Utfallet av én oppgave, valgt av testeren. Tre lukkede valg, aldri skala (rapport 4).
+ */
+type ProgramsTaskOutcome = 'fungerte' | 'delvis' | 'ikke';
+/**
+ * Minimal peker til en kjent feil, for visning i innsenderens liste.
+ */
+type SubmissionsKnownIssueRef = {
+    id: string;
+    title: string;
+};
+/**
+ * Begrunnelseskode ved avvist. Obligatorisk sammen med fritekst (DD-09). Fire koder, ingen «annet» — en søppelbøtte undergraver tvangen. Rapport 3 navngir kun ikke_prioritert; de tre andre er wireframens forslag og bekreftes av produkteier ved godkjenning av denne kontrakten.
+ */
+type SubmissionsReasonCode = 'ikke_prioritert' | 'utenfor_omfang' | 'kan_ikke_gjenskape' | 'allerede_mulig';
+/**
+ * Svaret fra leietakeren, slik innsenderen ser det i «mine innspill» (DD-27). Samme tekst som på saken i panelet.
+ */
+type SubmissionsReplyView = {
+    text: string;
+    reasonCode?: SubmissionsReasonCode;
+    at: string;
+};
+/**
+ * Statuskategori — maskinens felt, utledet av status (DD-22). reviewing: ny, vurderes · active: planlagt, bygges · complete: levert, kjent_feil med fikset KnownIssue · closed: avvist, duplikat.
+ */
+type SubmissionsStatusType = 'reviewing' | 'active' | 'complete' | 'closed';
+/**
+ * Tilstandsmaskinen i domain-model.md. Navnet innsenderen ser velges per spor i klienten (DD-22): levert vises som «Rettet» i feilsporet og «Levert» i ønskesporet; kjent_feil → fikset vises som «Rettet».
+ */
+type SubmissionsSubmissionStatus = 'ny' | 'vurderes' | 'planlagt' | 'bygges' | 'levert' | 'kjent_feil' | 'duplikat' | 'avvist';
+/**
+ * Innsenderens egen visning av en innsending. Ingen tekst fra andre, ingen notater, ingen Reach.
+ */
+type SubmissionsSubmissionStatusView = {
+    id: string;
+    type: SubmissionsSubmissionType;
+    /**
+     * Innsenderens egen tekst, speilet tilbake så «mine innspill» kan vises uten lokal lagring. Tom for kjent_feil-bekreftelser.
+     */
+    text: string;
+    status: SubmissionsSubmissionStatus;
+    /**
+     * Utledet av status (DD-22). Klienten velger visningsnavn per spor.
+     */
+    statusType: SubmissionsStatusType;
+    /**
+     * Svarfristen som dato — det eneste tidsløftet (DD-28). Satt kun i vurderes: statusChangedAt + leietakerens reviewDeadlineDays.
+     */
+    deadlineAt?: string;
+    /**
+     * Versjonen feilen er rettet i / ønsket levert i. Satt ved levert, og ved kjent_feil når KnownIssue er fikset (DD-31).
+     */
+    fixedIn?: string;
+    /**
+     * Kjent feil denne innsendingen bekreftet («Ja, jeg også») — kortets tittel så «mine innspill» kan vise hva som ble bekreftet.
+     */
+    knownIssue?: SubmissionsKnownIssueRef;
+    /**
+     * Kjent feil innsendingen ble lenket til med «Ligner, men ikke helt». Fjernes hvis behandleren avviser lenken.
+     */
+    relatedKnownIssue?: SubmissionsKnownIssueRef;
+    reply?: SubmissionsReplyView;
+    /**
+     * Om innsendingen har et vedlegg. Selve bildet returneres aldri her — det vises ikke i «mine innspill».
+     */
+    hasAttachment: boolean;
+    createdAt: string;
+    statusChangedAt: string;
+};
+/**
+ * Sporet. Første valg i widgeten er «Noe virker ikke» / «Jeg ønsker meg noe», aldri et tredje (DD-02).
+ */
+type SubmissionsSubmissionType = 'feil' | 'onske';
+
+/**
+ * Lagring injiseres av verten — kjernen har ingen nettleser-API-er (CLAUDE.md,
+ * «SDK»). Tre metoder er nok: offline-køen er det eneste som lagres, og
+ * feedback-tokenet lagres aldri (K20).
+ */
+interface InnspelStorage {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+}
+/**
+ * Gir et ferskt feedback-token fra vertens eget token-endepunkt (ES256,
+ * `aud=innspel`, `sub` = pseudonym, `exp` ≤ 15 min). Kalles hver gang et token
+ * trengs — kjernen cacher det aldri på disk.
+ *
+ * `null` som RETURVERDI betyr «ingen innlogget bruker akkurat nå»; `null` som
+ * OPSJON betyr anonym modus for hele klienten.
+ */
+type IdentityProvider = () => Promise<string | null> | string | null;
+/**
+ * Den lukkede hvitelista for teknisk kontekst (K5). Leses ved feltnavn — et
+ * ukjent felt avvises av `init` og `capture` med feltnavnet i meldingen, før
+ * det rekker å bli 400 unknown_field fra plattformen.
+ *
+ * Aldri enhets-ID, aldri IP, aldri hva som stod på skjermen: `screen` er rutens
+ * NAVN. `sdkVersion` settes av kjernen og kan ikke overstyres.
+ */
+interface ContextInput {
+    platform: CommonPlatform;
+    appVersion?: string;
+    build?: string;
+    os?: string;
+    screen?: string;
+    locale?: string;
+}
+/** Hendelsene i `docs/maaling.md`. Ingen av dem bærer tekst, skjermbilde eller pseudonym. */
+type TelemetryEvent = {
+    name: 'widget_opened';
+} | {
+    name: 'track_selected';
+    type: 'feil' | 'onske';
+} | {
+    name: 'known_issue_shown';
+    count: number;
+} | {
+    name: 'known_issue_confirmed';
+} | {
+    name: 'submission_sent';
+    type: 'feil' | 'onske';
+    hasAttachment: boolean;
+    offlineQueued: boolean;
+} | {
+    name: 'submission_failed';
+    reason: string;
+} | {
+    name: 'invitation_accepted';
+} | {
+    name: 'invitation_declined';
+} | {
+    name: 'task_completed';
+    outcome: string;
+} | {
+    name: 'followup_answered';
+} | {
+    name: 'status_viewed';
+};
+/**
+ * Telemetri går til et injisert grensesnitt. Standard er `noop`; plattformens
+ * eget mottak kobles på i M4.2 (tech-decisions.md). Uten opsjonen sendes
+ * ingenting noe sted.
+ */
+interface Telemetry {
+    emit(event: TelemetryEvent): void;
+}
+/** Tekstgrensen per leietaker. Lukket valg — kontrakten har to verdier. */
+type TextMaxLength = 140 | 280;
+interface InnspelOptions {
+    /** Plattformens API-rot. Ingen standard: SDK-et skal aldri gjette hvor dataene havner. */
+    baseUrl: string;
+    /**
+     * Den offentlige SDK-nøkkelen (`Product.key`). Skrivende, bundet til
+     * bundle-ID eller origin, kan aldri lese (K3). Hører hjemme i appens konfig.
+     */
+    tenantKey: string;
+    /**
+     * Funksjon som gir et ferskt feedback-token, eller `null` for anonym modus.
+     * Forkastet: stille fallback ved glemt opsjon — anonym modus er et eksplisitt
+     * valg (tech-decisions.md, «SDK — dokumentasjon og utvikleropplevelse»).
+     */
+    identityProvider: IdentityProvider | null;
+    /** Offline-køen bor her (DD-41). */
+    storage: InnspelStorage;
+    /** Teknisk kontekst som følger hver innsending. `platform` er påkrevd. */
+    context: ContextInput;
+    /**
+     * Leietakerens tekstgrense. Ingest-flaten har ingen klientkonfig ennå, så
+     * standarden er den strammeste (140, verdien ved `minorsPresent`). Verten
+     * overstyrer med verdien fra panelet.
+     */
+    textMaxLength?: TextMaxLength;
+    /** Send-knappen er aktiv fra dette antallet tegn. Standard 10 (DD-44). */
+    minTextLength?: number;
+    /**
+     * Om skjermbilde-steget finnes. Standard `false`: steget skal ikke være en
+     * deaktivert knapp, det skal ikke finnes (DD-26). Vedlegg er M1.3.
+     */
+    screenshotsEnabled?: boolean;
+    /** Standard er `noop`. */
+    telemetry?: Telemetry;
+    /** Injiserbar `fetch`, for test og for verter med egen nettverksstakk. */
+    fetch?: typeof fetch;
+    /** Tidsavbrudd per kall i millisekunder. Standard 10 000 (wireframe 2i). */
+    timeoutMs?: number;
+}
+/** Leietakerens innstillinger slik klienten kjenner dem. */
+interface ResolvedSettings {
+    textMaxLength: TextMaxLength;
+    minTextLength: number;
+    screenshotsEnabled: boolean;
+}
+/** Felles felter for begge spor. */
+interface CaptureBase {
+    text: string;
+    /** Legges på konteksten fra `init` — typisk `screen`. */
+    context?: Partial<ContextInput>;
+    /**
+     * Idempotensnøkkel for offline-køen. Settes av kjernen hvis den utelates:
+     * en ny UUID per INNSENDING, aldri per enhet eller installasjon (K20).
+     */
+    clientRef?: string;
+    /** Krever feedback-token og aktiv deltakelse. Betaprogram er M3. */
+    programId?: string;
+    taskId?: string;
+}
+/** «Noe virker ikke» — eneste spor med koblingsnøkler og lenke til kjent feil (DD-02). */
+interface CaptureFeil extends CaptureBase {
+    type: 'feil';
+    /** Opake koblingsnøkler til maskinsignaler hos leietakeren, maks tre. `crash` er forhåndsdefinert (DD-43). */
+    correlation?: CommonCorrelation[];
+    /** «Ligner, men ikke helt» (DD-29): lenke uten tvunget match. */
+    relatedKnownIssueId?: string;
+}
+/** «Jeg ønsker meg noe» — ingen koblingsnøkler, ingen reproduksjonsfelt (DD-02). */
+interface CaptureOnske extends CaptureBase {
+    type: 'onske';
+}
+type CaptureInput = CaptureFeil | CaptureOnske;
+type CaptureResult = {
+    status: 'sent';
+    submission: SubmissionsSubmissionStatusView;
+} | {
+    status: 'queued';
+    clientRef: string;
+};
+/** En rad i offline-køen. Kun tekst — et skjermbilde køes aldri (rapport 3, kap. 5). */
+interface QueuedSubmission {
+    clientRef: string;
+    type: 'feil' | 'onske';
+    text: string;
+    queuedAt: string;
+}
+/** Resultatet av en flush. */
+interface FlushResult {
+    sent: number;
+    /** Rader plattformen avviste med 400 — de blir aldri gyldige og forkastes. */
+    failed: number;
+    /** Rader som fortsatt venter, typisk fordi nettet er nede. */
+    remaining: number;
+}
+/**
+ * En rad i «Mine innspill» (DD-27, DD-41): plattformens egne innsendinger, pluss
+ * køen gjort synlig. `pending` skiller dem — en køet rad har ingen saksnummer.
+ */
+type MySubmission = (SubmissionsSubmissionStatusView & {
+    pending?: false;
+}) | {
+    pending: true;
+    clientRef: string;
+    type: 'feil' | 'onske';
+    text: string;
+    queuedAt: string;
+};
+/** Klassene mønstervarselet kjenner (DD-46). */
+type PatternKind = 'email' | 'phone' | 'card' | 'ip' | 'token';
+interface PatternFinding {
+    kind: PatternKind;
+    match: string;
+    start: number;
+    end: number;
+}
+interface KnownIssueQuery {
+    screen?: string;
+    version?: string;
+    platform?: CommonPlatform;
+}
+/**
+ * Visningen `openFeedback` åpner. Registreres av `@innspel/react-native`;
+ * kjernen har ingen UI (CLAUDE.md, «SDK»).
+ */
+interface Presenter {
+    open(options?: OpenFeedbackOptions): Promise<void>;
+}
+interface OpenFeedbackOptions {
+    /** Rutenavnet innsenderen kom fra. Styrer hvilke kjente feil som vises (DD-30). */
+    screen?: string;
+    /** Start i et bestemt spor og hopp over 2b. */
+    track?: 'feil' | 'onske';
+}
+
+/** Klienten `init` gir deg. Én per app; den er trygg å holde på. */
+interface InnspelClient {
+    /** Versjonen av `@innspel/core`. Følger med hver innsending som `context.sdkVersion`. */
+    readonly version: string;
+    /** `true` når `identityProvider` er `null` — innsendinger kan ikke følges opp. */
+    readonly isAnonymous: boolean;
+    /** Leietakerens grenser slik klienten kjenner dem. */
+    readonly settings: ResolvedSettings;
+    /** Konteksten som følger hver innsending, med `sdkVersion` satt av kjernen. */
+    readonly context: ContextInput & {
+        sdkVersion: string;
+    };
+    capture(input: CaptureInput): Promise<CaptureResult>;
+    readonly knownIssues: {
+        /** Kortene som vises FØR feltet i feilsporet (DD-03). Feiler oppslaget, er lista tom. */
+        for(query?: KnownIssueQuery): Promise<KnownIssuesKnownIssueCard[]>;
+        /** «Ja, jeg også» (DD-29): Reach +1 uten ny sak. */
+        confirm(knownIssueId: string): Promise<SubmissionsSubmissionStatusView>;
+    };
+    readonly subjects: {
+        /** «Mine innspill» (DD-27), med køen gjort synlig (DD-41). */
+        submissions(): Promise<MySubmission[]>;
+        status(submissionId: string): Promise<SubmissionsSubmissionStatusView>;
+    };
+    readonly programs: {
+        list(): Promise<ProgramsMyPrograms>;
+    };
+    readonly queue: {
+        pending(): Promise<QueuedSubmission[]>;
+        /** Sendes ellers automatisk når widgeten åpnes. Aldri ved oppstart (DD-41). */
+        flush(): Promise<FlushResult>;
+    };
+    /** Mønstervarsel (DD-46). Returnerer funn — fjerner aldri noe. */
+    scanText(text: string): PatternFinding[];
+    /** Emitter en tragt-hendelse. Brukes av UI-laget for `widget_opened` og `track_selected`. */
+    track(event: TelemetryEvent): void;
+    /** Åpner widgeten. Krever `@innspel/react-native`. */
+    openFeedback(options?: OpenFeedbackOptions): Promise<void>;
+    /** Registrerer visningen. Kalles av `@innspel/react-native`, ikke av verten. */
+    registerPresenter(presenter: Presenter): void;
+}
+/**
+ * Setter opp SDK-et. Validerer opsjonene ved kjøretid og kaster umiddelbart med
+ * feltnavnet ved feil bruk — typer stopper ikke en JavaScript-vert eller en feil
+ * `.env` (tech-decisions.md, «SDK — dokumentasjon og utvikleropplevelse»).
+ *
+ * Kaller ingenting og sender ingenting: køen tømmes ALDRI ved oppstart (DD-41).
+ *
+ * @example
+ * ```ts
+ * const innspel = init({
+ *   baseUrl: 'https://api.innspel.example',
+ *   tenantKey: 'ik_pub_xxxxxxxx',
+ *   identityProvider: hentFeedbackToken,   // eller null = anonym
+ *   storage,
+ *   context: { platform: 'ios', appVersion: '1.4.2' },
+ * });
+ * ```
+ */
+declare function init(options: InnspelOptions): InnspelClient;
+
+/**
+ * Leter etter e-post, telefonnummer, kortnummer (Luhn-validert), IP-adresser og
+ * token-lignende strenger i en innspillstekst.
+ *
+ * Rekkefølgen på reglene er bevisst: de spesifikke først, så et treff som
+ * allerede er dekket av en sterkere regel ikke varsles to ganger. Et kortnummer
+ * er ikke også et telefonnummer.
+ *
+ * @param text Teksten innsenderen har skrevet. Endres ikke.
+ * @returns Funnene med posisjon, så verten kan markere dem i feltet. Tom liste
+ *   for en vanlig innsending.
+ */
+declare function scanText(text: string): PatternFinding[];
+
+/**
+ * DD-41 — «Offline-køen er maks 30, tømmes aldri ved oppstart, og er synlig.»
+ *
+ * Kilde: Sentry `maxQueueSize` 30 og `flushAtStartup` false; Shake «Feedback
+ * pending sync» er den eneste leverandøren som viser tilstanden til brukeren.
+ * Kvitteringen i DD-07 kan ikke love svar på noe som ikke er sendt — derfor er
+ * køen synlig i «Mine innspill», ikke en usynlig bakgrunnsjobb.
+ *
+ * Rate limit-tallet per subject i M1.1 er satt til 60 nettopp for at en full kø
+ * på 30 skal kunne tømmes på ett minutt (tech-decisions.md, «M1.1»).
+ */
+declare const KO_TAK = 30;
+
+/**
+ * Utviklerfeil: opsjoner som er feil eller mangler, kontekstfelter utenfor
+ * hvitelisten, tekst utenfor grensene. Kastes umiddelbart og navngir feltet —
+ * aldri en stille tom widget (tech-decisions.md, «SDK — dokumentasjon og
+ * utvikleropplevelse»).
+ */
+declare class InnspelConfigError extends Error {
+    readonly name = "InnspelConfigError";
+    /** Feltet som er galt, slik det heter i `init`-opsjonene. */
+    readonly field: string;
+    constructor(field: string, hva: string, hvor?: string);
+}
+/**
+ * Feil fra plattformen. Forgren på `code`, aldri på `message` — meldingen er
+ * for mennesker og kan endres uten varsel (contracts/models/common.tsp).
+ */
+declare class InnspelApiError extends Error {
+    readonly name = "InnspelApiError";
+    readonly code: CommonErrorCode | 'unknown';
+    readonly status: number;
+    /** Sekunder til neste forsøk, fra Retry-After. Kun ved 429. */
+    readonly retryAfter: number | undefined;
+    constructor(status: number, code: CommonErrorCode | 'unknown', message: string, retryAfter?: number);
+}
+/**
+ * Offline-køen er full. Taket er 30 (DD-41), og den eldste beholdes: det første
+ * innspillet er like mye verdt som det siste, og å kaste det stille ville brutt
+ * løftet om at teksten aldri mistes.
+ */
+declare class InnspelQueueFullError extends Error {
+    readonly name = "InnspelQueueFullError";
+    readonly code: "queue_full";
+    /** Tekst som kan vises til innsenderen. Køen skal være synlig, ikke stille. */
+    readonly userMessage: string;
+    constructor(tak: number);
+}
+
+/**
+ * Den lukkede hvitelista (K5), som feltnavn. Listen er kilden både til
+ * valideringen og til det som faktisk sendes — et felt som ikke står her kommer
+ * aldri ut av kjernen, uansett hva verten fyller inn.
+ *
+ * `sdkVersion` står ikke her fordi den ikke kommer fra verten: kjernen setter
+ * den selv, og en vert som prøver å overstyre den blir ignorert.
+ */
+declare const KONTEKST_FELTER: readonly ["platform", "appVersion", "build", "os", "screen", "locale"];
+
+/**
+ * Versjonen som sendes som `context.sdkVersion` på hver innsending.
+ *
+ * `maaling.md` teller SDK-versjonsspredning per leietaker — «en gammel SDK er
+ * et vedlikeholdsproblem som ellers er usynlig». Derfor er dette en konstant og
+ * ikke et `require('../package.json')`: kjernen skal virke i en bundler som
+ * ikke kan lese JSON, og `test/versjon.test.ts` holder den i takt med
+ * `package.json`.
+ */
+declare const VERSJON = "0.1.0";
+
+export { type CaptureFeil, type CaptureInput, type CaptureOnske, type CaptureResult, type ContextInput, type CommonCorrelation as Correlation, type CommonErrorCode as ErrorCode, type FlushResult, type IdentityProvider, InnspelApiError, type InnspelClient, InnspelConfigError, type InnspelOptions, InnspelQueueFullError, type InnspelStorage, KONTEKST_FELTER, KO_TAK, type KnownIssuesKnownIssueCard as KnownIssueCard, type KnownIssueQuery, type SubmissionsKnownIssueRef as KnownIssueRef, type KnownIssuesKnownIssueStatus as KnownIssueStatus, type ProgramsMyPrograms as MyPrograms, type MySubmission, type OpenFeedbackOptions, type PatternFinding, type PatternKind, type CommonPlatform as Platform, type Presenter, type QueuedSubmission, type SubmissionsReasonCode as ReasonCode, type SubmissionsReplyView as ReplyView, type ResolvedSettings, type SubmissionsStatusType as StatusType, type SubmissionsSubmissionStatus as SubmissionStatus, type SubmissionsSubmissionStatusView as SubmissionStatusView, type SubmissionsSubmissionType as SubmissionType, type Telemetry, type TelemetryEvent, type TextMaxLength, VERSJON, init, scanText };