@innspel/core 0.2.1 → 0.4.0

package/dist/index.d.cts

@@ -353,11 +353,17 @@ interface InnspelOptions {
     /** Tidsavbrudd per kall i millisekunder. Standard 10 000 (wireframe 2i). */
     timeoutMs?: number;
 }
-/** Leietakerens innstillinger slik klienten kjenner dem. */
+/**
+ * Leietakerens innstillinger slik klienten kjenner dem. Starter som opsjonene fra
+ * `init()` (strammest mulig uten dem), og oppdateres av `loadSettings()` fra
+ * `GET /v1/ingest/config` (M2.5) — samme objekt, så en holdt referanse følger med.
+ */
 interface ResolvedSettings {
     textMaxLength: TextMaxLength;
     minTextLength: number;
     screenshotsEnabled: boolean;
+    /** Leietakerens personvernerklæring — «hva samles inn». Finnes først etter `loadSettings()`. */
+    privacyUrl?: string;
 }
 /**
  * Bildet slik verten gir det fra seg — Blob (React Native og nettleser),
@@ -500,12 +506,20 @@ interface InnspelClient {
     readonly version: string;
     /** `true` når `identityProvider` er `null` — innsendinger kan ikke følges opp. */
     readonly isAnonymous: boolean;
-    /** Leietakerens grenser slik klienten kjenner dem. */
+    /** Leietakerens grenser slik klienten kjenner dem. Oppdateres på plass av {@link loadSettings}. */
     readonly settings: ResolvedSettings;
     /** Konteksten som følger hver innsending, med `sdkVersion` satt av kjernen. */
     readonly context: ContextInput & {
         sdkVersion: string;
     };
+    /**
+     * Henter leietakerens klientkonfigurasjon (`GET /v1/ingest/config`, M2.5): tegngrense,
+     * minste antall tegn, skjermbilde og personvernlenke — det verten ellers måtte
+     * duplisere i `init()`. Kalles av widgeten ved åpning, aldri ved oppstart (DD-41).
+     * Svarer ikke kallet, beholdes det klienten alt har: konfigurasjonen er et tilbud,
+     * aldri en sperre. Returnerer `settings` — samme objekt, oppdatert.
+     */
+    loadSettings(): Promise<ResolvedSettings>;
     capture(input: CaptureInput): Promise<CaptureResult>;
     readonly knownIssues: {
         /** Kortene som vises FØR feltet i feilsporet (DD-03). Feiler oppslaget, er lista tom. */
@@ -519,7 +533,20 @@ interface InnspelClient {
         status(submissionId: string): Promise<SubmissionsSubmissionStatusView>;
     };
     readonly programs: {
+        /** Alt om betaprogram for innsenderen i ett kall: invitasjoner til banneret (DD-12), deltakelser til fanen, og oppfølginger som venter. */
         list(): Promise<ProgramsMyPrograms>;
+        /**
+         * Aksepterer invitasjonen etter forventningsavklaringen (DD-13, DD-32).
+         * Tokenet kom fra leietakerens egen kanal — plattformen sender aldri (DD-12).
+         * Er det brukt, utløpt eller utstedt til noen andre, kommer 404
+         * `invitation_invalid`. Gjentak fra samme innsender er trygt: svaret er den
+         * samme deltakelsen.
+         */
+        accept(invitationToken: string): Promise<ProgramsParticipationView>;
+        /** Avslår invitasjonen. Ingen årsak spørres. Et nei etter ja er {@link withdraw}, ikke avslag. */
+        decline(invitationToken: string): Promise<void>;
+        /** «Gå ut» (DD-36): umiddelbart, alltid tilgjengelig, og aldri en straff. Idempotent. */
+        withdraw(participationId: string): Promise<ProgramsParticipationView>;
     };
     readonly attachments: {
         /**
@@ -728,6 +755,6 @@ declare function dekkerAlt(rekter: readonly MaskRect[], bilde: {
  * ikke kan lese JSON, og `test/versjon.test.ts` holder den i takt med
  * `package.json`.
  */
-declare const VERSJON = "0.2.1";
+declare const VERSJON = "0.4.0";
 
-export { type AttachmentBody, type AttachmentInput, type SubmissionsAttachmentMime as AttachmentMime, type AttachmentOutcome, type SubmissionsAttachmentView as AttachmentView, 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 MaskPoint, type MaskRect, 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, TILLATTE_MIME, type Telemetry, type TelemetryEvent, type TextMaxLength, VEDLEGG_GRENSER, VERSJON, dekkerAlt, init, klipp, scanText, skaler, strokTilRekter, treffer, trykkTilRekt };
+export { type AttachmentBody, type AttachmentInput, type SubmissionsAttachmentMime as AttachmentMime, type AttachmentOutcome, type SubmissionsAttachmentView as AttachmentView, 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, type ProgramsInvitationView as InvitationView, KONTEKST_FELTER, KO_TAK, type KnownIssuesKnownIssueCard as KnownIssueCard, type KnownIssueQuery, type SubmissionsKnownIssueRef as KnownIssueRef, type KnownIssuesKnownIssueStatus as KnownIssueStatus, type MaskPoint, type MaskRect, type ProgramsMyPrograms as MyPrograms, type MySubmission, type OpenFeedbackOptions, type ProgramsParticipationView as ParticipationView, type PatternFinding, type PatternKind, type CommonPlatform as Platform, type Presenter, type ProgramsTask as ProgramTask, type ProgramsProgramView as ProgramView, 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, TILLATTE_MIME, type ProgramsTaskOutcome as TaskOutcome, type Telemetry, type TelemetryEvent, type TextMaxLength, VEDLEGG_GRENSER, VERSJON, dekkerAlt, init, klipp, scanText, skaler, strokTilRekter, treffer, trykkTilRekt };

package/dist/index.d.ts

@@ -353,11 +353,17 @@ interface InnspelOptions {
     /** Tidsavbrudd per kall i millisekunder. Standard 10 000 (wireframe 2i). */
     timeoutMs?: number;
 }
-/** Leietakerens innstillinger slik klienten kjenner dem. */
+/**
+ * Leietakerens innstillinger slik klienten kjenner dem. Starter som opsjonene fra
+ * `init()` (strammest mulig uten dem), og oppdateres av `loadSettings()` fra
+ * `GET /v1/ingest/config` (M2.5) — samme objekt, så en holdt referanse følger med.
+ */
 interface ResolvedSettings {
     textMaxLength: TextMaxLength;
     minTextLength: number;
     screenshotsEnabled: boolean;
+    /** Leietakerens personvernerklæring — «hva samles inn». Finnes først etter `loadSettings()`. */
+    privacyUrl?: string;
 }
 /**
  * Bildet slik verten gir det fra seg — Blob (React Native og nettleser),
@@ -500,12 +506,20 @@ interface InnspelClient {
     readonly version: string;
     /** `true` når `identityProvider` er `null` — innsendinger kan ikke følges opp. */
     readonly isAnonymous: boolean;
-    /** Leietakerens grenser slik klienten kjenner dem. */
+    /** Leietakerens grenser slik klienten kjenner dem. Oppdateres på plass av {@link loadSettings}. */
     readonly settings: ResolvedSettings;
     /** Konteksten som følger hver innsending, med `sdkVersion` satt av kjernen. */
     readonly context: ContextInput & {
         sdkVersion: string;
     };
+    /**
+     * Henter leietakerens klientkonfigurasjon (`GET /v1/ingest/config`, M2.5): tegngrense,
+     * minste antall tegn, skjermbilde og personvernlenke — det verten ellers måtte
+     * duplisere i `init()`. Kalles av widgeten ved åpning, aldri ved oppstart (DD-41).
+     * Svarer ikke kallet, beholdes det klienten alt har: konfigurasjonen er et tilbud,
+     * aldri en sperre. Returnerer `settings` — samme objekt, oppdatert.
+     */
+    loadSettings(): Promise<ResolvedSettings>;
     capture(input: CaptureInput): Promise<CaptureResult>;
     readonly knownIssues: {
         /** Kortene som vises FØR feltet i feilsporet (DD-03). Feiler oppslaget, er lista tom. */
@@ -519,7 +533,20 @@ interface InnspelClient {
         status(submissionId: string): Promise<SubmissionsSubmissionStatusView>;
     };
     readonly programs: {
+        /** Alt om betaprogram for innsenderen i ett kall: invitasjoner til banneret (DD-12), deltakelser til fanen, og oppfølginger som venter. */
         list(): Promise<ProgramsMyPrograms>;
+        /**
+         * Aksepterer invitasjonen etter forventningsavklaringen (DD-13, DD-32).
+         * Tokenet kom fra leietakerens egen kanal — plattformen sender aldri (DD-12).
+         * Er det brukt, utløpt eller utstedt til noen andre, kommer 404
+         * `invitation_invalid`. Gjentak fra samme innsender er trygt: svaret er den
+         * samme deltakelsen.
+         */
+        accept(invitationToken: string): Promise<ProgramsParticipationView>;
+        /** Avslår invitasjonen. Ingen årsak spørres. Et nei etter ja er {@link withdraw}, ikke avslag. */
+        decline(invitationToken: string): Promise<void>;
+        /** «Gå ut» (DD-36): umiddelbart, alltid tilgjengelig, og aldri en straff. Idempotent. */
+        withdraw(participationId: string): Promise<ProgramsParticipationView>;
     };
     readonly attachments: {
         /**
@@ -728,6 +755,6 @@ declare function dekkerAlt(rekter: readonly MaskRect[], bilde: {
  * ikke kan lese JSON, og `test/versjon.test.ts` holder den i takt med
  * `package.json`.
  */
-declare const VERSJON = "0.2.1";
+declare const VERSJON = "0.4.0";
 
-export { type AttachmentBody, type AttachmentInput, type SubmissionsAttachmentMime as AttachmentMime, type AttachmentOutcome, type SubmissionsAttachmentView as AttachmentView, 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 MaskPoint, type MaskRect, 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, TILLATTE_MIME, type Telemetry, type TelemetryEvent, type TextMaxLength, VEDLEGG_GRENSER, VERSJON, dekkerAlt, init, klipp, scanText, skaler, strokTilRekter, treffer, trykkTilRekt };
+export { type AttachmentBody, type AttachmentInput, type SubmissionsAttachmentMime as AttachmentMime, type AttachmentOutcome, type SubmissionsAttachmentView as AttachmentView, 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, type ProgramsInvitationView as InvitationView, KONTEKST_FELTER, KO_TAK, type KnownIssuesKnownIssueCard as KnownIssueCard, type KnownIssueQuery, type SubmissionsKnownIssueRef as KnownIssueRef, type KnownIssuesKnownIssueStatus as KnownIssueStatus, type MaskPoint, type MaskRect, type ProgramsMyPrograms as MyPrograms, type MySubmission, type OpenFeedbackOptions, type ProgramsParticipationView as ParticipationView, type PatternFinding, type PatternKind, type CommonPlatform as Platform, type Presenter, type ProgramsTask as ProgramTask, type ProgramsProgramView as ProgramView, 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, TILLATTE_MIME, type ProgramsTaskOutcome as TaskOutcome, type Telemetry, type TelemetryEvent, type TextMaxLength, VEDLEGG_GRENSER, VERSJON, dekkerAlt, init, klipp, scanText, skaler, strokTilRekter, treffer, trykkTilRekt };

package/dist/index.js

@@ -800,6 +800,33 @@ var attachmentsComplete = (options) => (options.client ?? client).post({
   url: "/v1/ingest/attachments/{id}/complete",
   ...options
 });
+var configGet = (options) => (options?.client ?? client).get({
+  security: [{ name: "X-Innspel-Tenant-Key", type: "apiKey" }, {
+    key: "FeedbackTokenAuth",
+    scheme: "bearer",
+    type: "http"
+  }],
+  url: "/v1/ingest/config",
+  ...options
+});
+var programsAccept = (options) => (options.client ?? client).post({
+  security: [{ name: "X-Innspel-Tenant-Key", type: "apiKey" }, {
+    key: "FeedbackTokenAuth",
+    scheme: "bearer",
+    type: "http"
+  }],
+  url: "/v1/ingest/invitations/{token}/accept",
+  ...options
+});
+var programsDecline = (options) => (options.client ?? client).post({
+  security: [{ name: "X-Innspel-Tenant-Key", type: "apiKey" }, {
+    key: "FeedbackTokenAuth",
+    scheme: "bearer",
+    type: "http"
+  }],
+  url: "/v1/ingest/invitations/{token}/decline",
+  ...options
+});
 var knownIssuesList2 = (options) => (options?.client ?? client).get({
   security: [{ name: "X-Innspel-Tenant-Key", type: "apiKey" }, {
     key: "FeedbackTokenAuth",
@@ -822,6 +849,15 @@ var knownIssuesConfirm = (options) => (options.client ?? client).post({
     ...options.headers
   }
 });
+var programsWithdraw = (options) => (options.client ?? client).post({
+  security: [{ name: "X-Innspel-Tenant-Key", type: "apiKey" }, {
+    key: "FeedbackTokenAuth",
+    scheme: "bearer",
+    type: "http"
+  }],
+  url: "/v1/ingest/participations/{id}/withdraw",
+  ...options
+});
 var programsListMine = (options) => (options?.client ?? client).get({
   security: [{ name: "X-Innspel-Tenant-Key", type: "apiKey" }, {
     key: "FeedbackTokenAuth",
@@ -1208,7 +1244,7 @@ async function lastOppTilLagring(fetchImpl, presign, body, signal) {
 }
 
 // src/versjon.ts
-var VERSJON = "0.2.1";
+var VERSJON = "0.4.0";
 
 // src/klient.ts
 var STANDARD_TIMEOUT_MS = 1e4;
@@ -1280,8 +1316,9 @@ function tilApiFeil(status, kropp, response) {
 function init(options) {
   validerOpsjoner(options);
   const settings = {
-    // Strammest mulig som standard: ingest-flaten har ingen klientkonfig, og
-    // 140 / skjermbilde av er verdiene ved minorsPresent (K18).
+    // Strammest mulig til loadSettings() har svart: 140 / 10 / skjermbilde av er
+    // verdiene ved minorsPresent (K18). Verten kan overstyre startverdiene, men
+    // det leietakeren har satt i panelet vinner når konfigurasjonen er hentet.
     textMaxLength: options.textMaxLength ?? 140,
     minTextLength: options.minTextLength ?? 10,
     screenshotsEnabled: options.screenshotsEnabled ?? false
@@ -1317,6 +1354,14 @@ function init(options) {
     if (!res.response.ok) throw tilApiFeil(res.response.status, res.error, res.response);
     return res.data;
   }
+  function krevInvitasjonstoken(token) {
+    if (typeof token !== "string" || token.length === 0) {
+      throw new InnspelConfigError(
+        "invitationToken",
+        "mangler \u2014 det er engangs-tokenet leietakeren sendte i sin egen kanal (dyplenke, varsel eller e-post)"
+      );
+    }
+  }
   function krevToken() {
     if (anonym) {
       throw new InnspelApiError(
@@ -1385,6 +1430,19 @@ function init(options) {
     isAnonymous: anonym,
     settings,
     context: kontekst,
+    async loadSettings() {
+      try {
+        const cfg = await medToken(
+          (h) => configGet({ client: klient, headers: h, signal: signal() })
+        );
+        if (cfg?.textMaxLength === 140 || cfg?.textMaxLength === 280) settings.textMaxLength = cfg.textMaxLength;
+        if (typeof cfg?.minTextLength === "number" && cfg.minTextLength >= 1) settings.minTextLength = cfg.minTextLength;
+        if (typeof cfg?.screenshotsEnabled === "boolean") settings.screenshotsEnabled = cfg.screenshotsEnabled;
+        if (typeof cfg?.privacyUrl === "string" && cfg.privacyUrl) settings.privacyUrl = cfg.privacyUrl;
+      } catch {
+      }
+      return settings;
+    },
     async capture(input) {
       const tekst = input.text ?? "";
       if (tekst.length < settings.minTextLength) {
@@ -1517,6 +1575,47 @@ function init(options) {
         return medToken(
           (h) => programsListMine({ client: klient, headers: h, signal: signal() })
         );
+      },
+      async accept(invitationToken) {
+        krevInvitasjonstoken(invitationToken);
+        krevToken();
+        const svar = await medToken(
+          (h) => programsAccept({
+            client: klient,
+            headers: h,
+            signal: signal(),
+            path: { token: invitationToken }
+          })
+        );
+        telemetri.emit({ name: "invitation_accepted" });
+        return svar;
+      },
+      async decline(invitationToken) {
+        krevInvitasjonstoken(invitationToken);
+        krevToken();
+        await medToken(
+          (h) => programsDecline({
+            client: klient,
+            headers: h,
+            signal: signal(),
+            path: { token: invitationToken }
+          })
+        );
+        telemetri.emit({ name: "invitation_declined" });
+      },
+      async withdraw(participationId) {
+        if (typeof participationId !== "string" || participationId.length === 0) {
+          throw new InnspelConfigError("participationId", "mangler \u2014 bruk id fra deltakelsen i programs.list()");
+        }
+        krevToken();
+        return medToken(
+          (h) => programsWithdraw({
+            client: klient,
+            headers: h,
+            signal: signal(),
+            path: { id: participationId }
+          })
+        );
       }
     },
     attachments: {