@journai/feedback-core 0.1.0

package/dist/src/cards/categoryCard.d.ts

@@ -0,0 +1,2 @@
+import type { EntryPath, AdaptiveCard } from '../types.js';
+export declare function buildCategoryCard(entryPath: EntryPath): AdaptiveCard;

package/dist/src/cards/categoryCard.js

@@ -0,0 +1,27 @@
+export function buildCategoryCard(entryPath) {
+    const actions = [
+        { type: 'Action.Submit', title: '🐛 Fehler', style: 'default', data: { feedbackAction: 'selectCategory', category: 'bug' } },
+        { type: 'Action.Submit', title: '🔄 Änderung', style: 'default', data: { feedbackAction: 'selectCategory', category: 'change' } },
+        { type: 'Action.Submit', title: '💡 Idee', style: 'default', data: { feedbackAction: 'selectCategory', category: 'idea' } },
+    ];
+    if (entryPath === 'general') {
+        actions.push({ type: 'Action.Submit', title: '❓ Sonstiges', style: 'default', data: { feedbackAction: 'selectCategory', category: 'other' } });
+    }
+    return {
+        $schema: 'http://adaptivecards.io/schemas/adaptive-card.json',
+        type: 'AdaptiveCard',
+        version: '1.5',
+        body: [
+            { type: 'TextBlock', text: '📋 Was möchtest du uns mitteilen?', weight: 'Bolder', size: 'Medium' },
+            {
+                type: 'TextBlock',
+                text: 'Bezieht sich auf die markierte Antwort. Der Verlauf wird automatisch mitgesendet.',
+                isSubtle: true,
+                wrap: true,
+                isVisible: entryPath === 'marker',
+            },
+        ],
+        actions,
+    };
+}
+//# sourceMappingURL=categoryCard.js.map

package/dist/src/cards/categoryCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categoryCard.js","sourceRoot":"","sources":["../../../src/cards/categoryCard.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,SAAoB;IACpD,MAAM,OAAO,GAAwF;QACnG,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;QAC5H,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE;QACjI,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;KAC5H,CAAC;IAEF,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IACjJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,oDAAoD;QAC7D,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE;YACJ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,mCAAmC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;YAClG;gBACE,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,mFAAmF;gBACzF,QAAQ,EAAE,IAAI;gBACd,IAAI,EAAE,IAAI;gBACV,SAAS,EAAE,SAAS,KAAK,QAAQ;aAClC;SACF;QACD,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/src/cards/confirmationCard.d.ts

@@ -0,0 +1,2 @@
+import type { AdaptiveCard } from '../types.js';
+export declare function buildConfirmationCard(feedbackId: string, undoToken: string): AdaptiveCard;

package/dist/src/cards/confirmationCard.js

@@ -0,0 +1,15 @@
+export function buildConfirmationCard(feedbackId, undoToken) {
+    return {
+        $schema: 'http://adaptivecards.io/schemas/adaptive-card.json',
+        type: 'AdaptiveCard',
+        version: '1.5',
+        body: [
+            { type: 'TextBlock', text: '✓ Danke für deine Rückmeldung!', weight: 'Bolder', size: 'Medium' },
+            { type: 'TextBlock', text: 'Wir schauen uns das an.', isSubtle: true, wrap: true },
+        ],
+        actions: [
+            { type: 'Action.Submit', title: '↩️ Zurücknehmen', style: 'default', data: { feedbackAction: 'undoFeedback', feedbackId, undoToken } },
+        ],
+    };
+}
+//# sourceMappingURL=confirmationCard.js.map

package/dist/src/cards/confirmationCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmationCard.js","sourceRoot":"","sources":["../../../src/cards/confirmationCard.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CAAC,UAAkB,EAAE,SAAiB;IACzE,OAAO;QACL,OAAO,EAAE,oDAAoD;QAC7D,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE;YACJ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,gCAAgC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/F,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,yBAAyB,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;SACnF;QACD,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE;SACvI;KACF,CAAC;AACJ,CAAC"}

package/dist/src/cards/detailsCard.d.ts

@@ -0,0 +1,2 @@
+import type { FeedbackCategory, AdaptiveCard } from '../types.js';
+export declare function buildDetailsCard(category: FeedbackCategory): AdaptiveCard;

package/dist/src/cards/detailsCard.js

@@ -0,0 +1,45 @@
+const CATEGORY_LABELS = {
+    bug: '🐛 Fehler',
+    change: '🔄 Änderung',
+    idea: '💡 Idee',
+    other: '❓ Sonstiges',
+};
+export function buildDetailsCard(category) {
+    return {
+        $schema: 'http://adaptivecards.io/schemas/adaptive-card.json',
+        type: 'AdaptiveCard',
+        version: '1.5',
+        body: [
+            { type: 'TextBlock', text: '📋 Deine Rückmeldung', weight: 'Bolder', size: 'Medium' },
+            { type: 'TextBlock', text: `Kategorie: ${CATEGORY_LABELS[category]} ✓`, isSubtle: true },
+            {
+                type: 'Input.Text',
+                id: 'description',
+                label: 'Beschreibe das Problem (optional):',
+                placeholder: 'z.B. "Die Antwort enthält falsche Zahlen"',
+                isMultiline: true,
+                maxLength: 500,
+                isRequired: false,
+            },
+            {
+                type: 'Input.Toggle',
+                id: 'wantsScreenshot',
+                title: 'Ich möchte einen Screenshot anfügen',
+                value: 'false',
+                valueOn: 'true',
+                valueOff: 'false',
+            },
+            {
+                type: 'TextBlock',
+                text: 'ℹ️ Nach dem Absenden kannst du den Screenshot direkt als Bild in diesen Chat senden. 💡 Tipp: Windows+Shift+S',
+                isSubtle: true,
+                wrap: true,
+                size: 'Small',
+            },
+        ],
+        actions: [
+            { type: 'Action.Submit', title: '📤 Absenden', style: 'positive', data: { feedbackAction: 'submitFeedback', category } },
+        ],
+    };
+}
+//# sourceMappingURL=detailsCard.js.map

package/dist/src/cards/detailsCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detailsCard.js","sourceRoot":"","sources":["../../../src/cards/detailsCard.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAAqC;IACxD,GAAG,EAAE,WAAW;IAChB,MAAM,EAAE,aAAa;IACrB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,aAAa;CACrB,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,QAA0B;IACzD,OAAO;QACL,OAAO,EAAE,oDAAoD;QAC7D,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE;YACJ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,sBAAsB,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;YACrF,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,eAAe,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;YACxF;gBACE,IAAI,EAAE,YAAY;gBAClB,EAAE,EAAE,aAAa;gBACjB,KAAK,EAAE,oCAAoC;gBAC3C,WAAW,EAAE,2CAA2C;gBACxD,WAAW,EAAE,IAAI;gBACjB,SAAS,EAAE,GAAG;gBACd,UAAU,EAAE,KAAK;aAClB;YACD;gBACE,IAAI,EAAE,cAAc;gBACpB,EAAE,EAAE,iBAAiB;gBACrB,KAAK,EAAE,qCAAqC;gBAC5C,KAAK,EAAE,OAAO;gBACd,OAAO,EAAE,MAAM;gBACf,QAAQ,EAAE,OAAO;aAClB;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,+GAA+G;gBACrH,QAAQ,EAAE,IAAI;gBACd,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,OAAO;aACd;SACF;QACD,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE;SACzH;KACF,CAAC;AACJ,CAAC"}

package/dist/src/cards/index.d.ts

@@ -0,0 +1,5 @@
+export { buildCategoryCard } from './categoryCard.js';
+export { buildDetailsCard } from './detailsCard.js';
+export { buildConfirmationCard } from './confirmationCard.js';
+export { buildUndoneCard } from './undoneCard.js';
+export { buildInlineButtons } from './inlineButtons.js';

package/dist/src/cards/index.js

@@ -0,0 +1,7 @@
+// Card builder exports — no SDK dependency
+export { buildCategoryCard } from './categoryCard.js';
+export { buildDetailsCard } from './detailsCard.js';
+export { buildConfirmationCard } from './confirmationCard.js';
+export { buildUndoneCard } from './undoneCard.js';
+export { buildInlineButtons } from './inlineButtons.js';
+//# sourceMappingURL=index.js.map

package/dist/src/cards/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cards/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/cards/inlineButtons.d.ts

@@ -0,0 +1,2 @@
+import type { AdaptiveCard } from '../types.js';
+export declare function buildInlineButtons(botResponseText: string): AdaptiveCard;

package/dist/src/cards/inlineButtons.js

@@ -0,0 +1,16 @@
+export function buildInlineButtons(botResponseText) {
+    return {
+        $schema: 'http://adaptivecards.io/schemas/adaptive-card.json',
+        type: 'AdaptiveCard',
+        version: '1.5',
+        body: [
+            { type: 'TextBlock', text: botResponseText, wrap: true },
+        ],
+        actions: [
+            { type: 'Action.Submit', title: '⚑ Stimmt nicht', style: 'default', data: { feedbackAction: 'reportIssue', entryPath: 'marker' } },
+            { type: 'Action.Submit', title: '💬 Anders erklären', style: 'default', data: { feedbackAction: 'explainDifferently' } },
+            { type: 'Action.Submit', title: '🔄 Nochmal', style: 'default', data: { feedbackAction: 'regenerate' } },
+        ],
+    };
+}
+//# sourceMappingURL=inlineButtons.js.map

package/dist/src/cards/inlineButtons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlineButtons.js","sourceRoot":"","sources":["../../../src/cards/inlineButtons.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,eAAuB;IACxD,OAAO;QACL,OAAO,EAAE,oDAAoD;QAC7D,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE;YACJ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,EAAE;SACzD;QACD,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE;YAClI,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,cAAc,EAAE,oBAAoB,EAAE,EAAE;YACxH,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,EAAE;SACzG;KACF,CAAC;AACJ,CAAC"}

package/dist/src/cards/undoneCard.d.ts

@@ -0,0 +1,2 @@
+import type { AdaptiveCard } from '../types.js';
+export declare function buildUndoneCard(): AdaptiveCard;

package/dist/src/cards/undoneCard.js

@@ -0,0 +1,11 @@
+export function buildUndoneCard() {
+    return {
+        $schema: 'http://adaptivecards.io/schemas/adaptive-card.json',
+        type: 'AdaptiveCard',
+        version: '1.5',
+        body: [
+            { type: 'TextBlock', text: '↩️ Feedback wurde zurückgenommen.', wrap: true },
+        ],
+    };
+}
+//# sourceMappingURL=undoneCard.js.map

package/dist/src/cards/undoneCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"undoneCard.js","sourceRoot":"","sources":["../../../src/cards/undoneCard.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,OAAO,EAAE,oDAAoD;QAC7D,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE;YACJ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,mCAAmC,EAAE,IAAI,EAAE,IAAI,EAAE;SAC7E;KACF,CAAC;AACJ,CAAC"}

package/dist/src/client.d.ts

@@ -0,0 +1,9 @@
+import type { SubmitFeedbackPayload, SubmitFeedbackResponse, UndoFeedbackResponse, UploadScreenshotResponse } from './types.js';
+export declare class FeedbackClient {
+    private apiEndpoint;
+    private apiKey;
+    constructor(apiEndpoint: string, apiKey: string);
+    submitFeedback(payload: SubmitFeedbackPayload): Promise<SubmitFeedbackResponse>;
+    undoFeedback(feedbackId: string, undoToken: string): Promise<UndoFeedbackResponse>;
+    uploadScreenshot(feedbackId: string, imageBuffer: Buffer, contentType: string): Promise<UploadScreenshotResponse>;
+}

package/dist/src/client.js

@@ -0,0 +1,44 @@
+export class FeedbackClient {
+    apiEndpoint;
+    apiKey;
+    constructor(apiEndpoint, apiKey) {
+        this.apiEndpoint = apiEndpoint;
+        this.apiKey = apiKey;
+    }
+    async submitFeedback(payload) {
+        const res = await fetch(`${this.apiEndpoint}/feedback`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'x-api-key': this.apiKey },
+            body: JSON.stringify(payload),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new Error(`Submit failed (${res.status}): ${err.error ?? 'Unknown'}`);
+        }
+        return res.json();
+    }
+    async undoFeedback(feedbackId, undoToken) {
+        const res = await fetch(`${this.apiEndpoint}/feedback/${feedbackId}/undo`, {
+            method: 'DELETE',
+            headers: { 'x-undo-token': undoToken, 'x-api-key': this.apiKey },
+        });
+        if (res.status === 200)
+            return { success: true, expired: false };
+        if (res.status === 410)
+            return { success: false, expired: true };
+        return { success: false, expired: false };
+    }
+    async uploadScreenshot(feedbackId, imageBuffer, contentType) {
+        const res = await fetch(`${this.apiEndpoint}/feedback/${feedbackId}/screenshot`, {
+            method: 'POST',
+            headers: { 'Content-Type': contentType, 'x-api-key': this.apiKey },
+            body: new Uint8Array(imageBuffer),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new Error(`Screenshot upload failed (${res.status}): ${err.error ?? 'Unknown'}`);
+        }
+        return res.json();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,cAAc;IACL;IAA6B;IAAjD,YAAoB,WAAmB,EAAU,MAAc;QAA3C,gBAAW,GAAX,WAAW,CAAQ;QAAU,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAEnE,KAAK,CAAC,cAAc,CAAC,OAA8B;QACjD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,WAAW,EAAE;YACtD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE;YACzE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC,MAAM,MAAO,GAA0B,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC,CAAC;QACtG,CAAC;QACD,OAAO,GAAG,CAAC,IAAI,EAAqC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,UAAkB,EAAE,SAAiB;QACtD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,aAAa,UAAU,OAAO,EAAE;YACzE,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE;SACjE,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACjE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACjE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAAkB,EAAE,WAAmB,EAAE,WAAmB;QACjF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,aAAa,UAAU,aAAa,EAAE;YAC/E,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE;YAClE,IAAI,EAAE,IAAI,UAAU,CAAC,WAAW,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,CAAC,MAAM,MAAO,GAA0B,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC,CAAC;QACjH,CAAC;QACD,OAAO,GAAG,CAAC,IAAI,EAAuC,CAAC;IACzD,CAAC;CACF"}

package/dist/src/flow.d.ts

@@ -0,0 +1,49 @@
+import type { FeedbackAction, ChannelType, SubmitFeedbackPayload, AdaptiveCard } from './types.js';
+import type { FeedbackClient } from './client.js';
+import type { ScreenshotTracker } from './screenshot.js';
+export interface FeedbackContext {
+    userId: string;
+    userName?: string;
+    conversationId: string;
+    channelType: ChannelType;
+    agentName?: string;
+    markedMessageText?: string;
+    recentMessages?: Array<{
+        role: string;
+        text: string;
+    }>;
+}
+export interface FeedbackFlowResult {
+    /** Adaptive Card JSON to send */
+    card?: AdaptiveCard;
+    /** Plain text message to send (e.g., screenshot prompt) */
+    message?: string;
+    screenshotPending?: boolean;
+    feedbackId?: string;
+    /**
+     * Whether the card should replace (update) the previous card in the conversation.
+     * True for selectCategory, submitFeedback, undoFeedback.
+     * False for reportIssue (always new card).
+     * Consumers that support updateActivity should use this flag.
+     */
+    replacesPreviousCard?: boolean;
+}
+export interface HandleFeedbackOptions {
+    /**
+     * Called before submitting feedback to allow SDK layers to inject
+     * SDK-specific fields like conversationReference and correlation.
+     */
+    enrichPayload?: (payload: SubmitFeedbackPayload) => SubmitFeedbackPayload;
+    /** Screenshot tracker for managing pending screenshot uploads. */
+    screenshotTracker?: ScreenshotTracker;
+    /** Timeout in ms for pending screenshot uploads. Defaults to 60000. */
+    screenshotTimeoutMs?: number;
+}
+/** Type guard: checks if value is a FeedbackAction with a feedbackAction string. */
+export declare function isFeedbackAction(value: unknown): value is FeedbackAction;
+/**
+ * SDK-agnostic feedback flow handler.
+ * Processes a feedback action and returns the result card/message to send.
+ * Does NOT call context.sendActivity — the consumer does that.
+ */
+export declare function handleFeedbackAction(action: FeedbackAction, client: FeedbackClient, context: FeedbackContext, options?: HandleFeedbackOptions): Promise<FeedbackFlowResult>;

package/dist/src/flow.js

@@ -0,0 +1,104 @@
+import { buildCategoryCard } from './cards/categoryCard.js';
+import { buildDetailsCard } from './cards/detailsCard.js';
+import { buildConfirmationCard } from './cards/confirmationCard.js';
+import { buildUndoneCard } from './cards/undoneCard.js';
+/** Type guard: checks if value is a FeedbackAction with a feedbackAction string. */
+export function isFeedbackAction(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'feedbackAction' in value &&
+        typeof value['feedbackAction'] === 'string');
+}
+/**
+ * SDK-agnostic feedback flow handler.
+ * Processes a feedback action and returns the result card/message to send.
+ * Does NOT call context.sendActivity — the consumer does that.
+ */
+export async function handleFeedbackAction(action, client, context, options) {
+    switch (action.feedbackAction) {
+        case 'reportIssue':
+            return { card: buildCategoryCard(action.entryPath ?? 'marker'), replacesPreviousCard: false };
+        case 'selectCategory':
+            return { card: buildDetailsCard((action.category ?? 'bug')), replacesPreviousCard: true };
+        case 'submitFeedback':
+            return handleSubmitFeedback(action, client, context, options);
+        case 'undoFeedback':
+            return handleUndoFeedback(action, client, context, options);
+        default:
+            return {};
+    }
+}
+async function handleSubmitFeedback(action, client, context, options) {
+    let payload = {
+        category: (action.category ?? 'bug'),
+        entryPath: action.entryPath ?? 'marker',
+        description: action.description,
+        userId: context.userId,
+        userName: context.userName,
+        conversationId: context.conversationId,
+        channelType: context.channelType,
+        topicName: context.agentName,
+        markedMessageText: context.markedMessageText,
+    };
+    if (options?.enrichPayload) {
+        payload = options.enrichPayload(payload);
+    }
+    try {
+        const result = await client.submitFeedback(payload);
+        const wantsScreenshot = action.wantsScreenshot === true || action.wantsScreenshot === 'true';
+        if (wantsScreenshot && options?.screenshotTracker) {
+            const timeoutMs = options.screenshotTimeoutMs ?? 60_000;
+            options.screenshotTracker.registerPending(context.conversationId, result.feedbackId, timeoutMs);
+        }
+        const flowResult = {
+            card: buildConfirmationCard(result.feedbackId, result.undoToken),
+            screenshotPending: wantsScreenshot,
+            feedbackId: result.feedbackId,
+            replacesPreviousCard: true,
+        };
+        if (wantsScreenshot) {
+            flowResult.message = 'Sende jetzt deinen Screenshot als Bild in diesen Chat.';
+        }
+        return flowResult;
+    }
+    catch {
+        return { message: 'Entschuldigung, beim Senden ist ein Fehler aufgetreten. Bitte versuche es später nochmal.' };
+    }
+}
+async function handleUndoFeedback(action, client, context, options) {
+    if (!action.feedbackId || !action.undoToken) {
+        return { message: 'Undo konnte nicht durchgeführt werden. Bitte versuche es später nochmal.' };
+    }
+    let result;
+    try {
+        result = await client.undoFeedback(action.feedbackId, action.undoToken);
+    }
+    catch {
+        return { message: 'Undo konnte nicht durchgeführt werden. Bitte versuche es später nochmal.' };
+    }
+    if (result.success) {
+        options?.screenshotTracker?.clearPending(context.conversationId);
+        return { card: buildUndoneCard(), replacesPreviousCard: true };
+    }
+    if (result.expired) {
+        return {
+            card: {
+                $schema: 'http://adaptivecards.io/schemas/adaptive-card.json',
+                type: 'AdaptiveCard',
+                version: '1.5',
+                body: [{ type: 'TextBlock', text: '⏱️ Das Undo-Fenster ist abgelaufen. Das Feedback bleibt gespeichert.', wrap: true }],
+            },
+            replacesPreviousCard: true,
+        };
+    }
+    return {
+        card: {
+            $schema: 'http://adaptivecards.io/schemas/adaptive-card.json',
+            type: 'AdaptiveCard',
+            version: '1.5',
+            body: [{ type: 'TextBlock', text: 'Undo konnte nicht durchgeführt werden.', wrap: true }],
+        },
+        replacesPreviousCard: true,
+    };
+}
+//# sourceMappingURL=flow.js.map

package/dist/src/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../src/flow.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './client.js';
+export * from './cards/index.js';
+export * from './flow.js';
+export * from './wrap.js';
+export * from './screenshot.js';

package/dist/src/index.js

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './client.js';
+export * from './cards/index.js';
+export * from './flow.js';
+export * from './wrap.js';
+export * from './screenshot.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}

package/dist/src/screenshot.d.ts

@@ -0,0 +1,11 @@
+export interface PendingScreenshot {
+    feedbackId: string;
+    expiresAt: number;
+}
+/** Pure state tracker for pending screenshot uploads. No SDK dependency. */
+export declare class ScreenshotTracker {
+    private pending;
+    registerPending(conversationId: string, feedbackId: string, timeoutMs: number): void;
+    getPending(conversationId: string): PendingScreenshot | undefined;
+    clearPending(conversationId: string): void;
+}

package/dist/src/screenshot.js

@@ -0,0 +1,24 @@
+/** Pure state tracker for pending screenshot uploads. No SDK dependency. */
+export class ScreenshotTracker {
+    pending = new Map();
+    registerPending(conversationId, feedbackId, timeoutMs) {
+        this.pending.set(conversationId, {
+            feedbackId,
+            expiresAt: Date.now() + timeoutMs,
+        });
+    }
+    getPending(conversationId) {
+        const entry = this.pending.get(conversationId);
+        if (!entry)
+            return undefined;
+        if (Date.now() >= entry.expiresAt) {
+            this.pending.delete(conversationId);
+            return undefined;
+        }
+        return entry;
+    }
+    clearPending(conversationId) {
+        this.pending.delete(conversationId);
+    }
+}
+//# sourceMappingURL=screenshot.js.map

package/dist/src/screenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../src/screenshot.ts"],"names":[],"mappings":"AAKA,4EAA4E;AAC5E,MAAM,OAAO,iBAAiB;IACpB,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEvD,eAAe,CAAC,cAAsB,EAAE,UAAkB,EAAE,SAAiB;QAC3E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE;YAC/B,UAAU;YACV,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SAClC,CAAC,CAAC;IACL,CAAC;IAED,UAAU,CAAC,cAAsB;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;YACpC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,YAAY,CAAC,cAAsB;QACjC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/src/types.d.ts

@@ -0,0 +1,68 @@
+/** Minimal Adaptive Card schema shared by all card builder functions. */
+export interface AdaptiveCard {
+    $schema: string;
+    type: 'AdaptiveCard';
+    version: string;
+    body: unknown[];
+    actions?: unknown[];
+}
+export interface FeedbackOptions {
+    apiEndpoint: string;
+    apiKey: string;
+    agentName?: string;
+    undoWindowSeconds?: number;
+    screenshotTimeoutSeconds?: number;
+    enableScreenshots?: boolean;
+}
+export type FeedbackCategory = 'bug' | 'change' | 'idea' | 'other';
+export type EntryPath = 'marker' | 'general';
+export type ChannelType = 'personal' | 'channel' | 'groupChat';
+export interface FeedbackAction {
+    feedbackAction: string;
+    category?: FeedbackCategory;
+    entryPath?: EntryPath;
+    description?: string;
+    wantsScreenshot?: boolean | string;
+    feedbackId?: string;
+    undoToken?: string;
+    feedbackFlowId?: string;
+}
+export interface SubmitFeedbackPayload {
+    category: FeedbackCategory;
+    entryPath: EntryPath;
+    description?: string;
+    userId: string;
+    userName?: string;
+    userEmail?: string;
+    conversationId: string;
+    channelType: ChannelType;
+    conversationReference?: object;
+    markedMessageText?: string;
+    conversationContext?: object[];
+    topicName?: string;
+    correlation?: CorrelationContext;
+}
+export interface CorrelationContext {
+    markedActivityId?: string;
+    userActivityId?: string;
+    feedbackActivityId?: string;
+    appInsightsOpId?: string;
+    appInsightsResourceId?: string;
+    copilotSessionId?: string;
+    copilotTraceId?: string;
+}
+export interface SubmitFeedbackResponse {
+    feedbackId: string;
+    undoToken: string;
+    undoExpiresAt: string;
+    message: string;
+}
+export interface UndoFeedbackResponse {
+    success: boolean;
+    expired: boolean;
+}
+export interface UploadScreenshotResponse {
+    screenshotId: string;
+    index: number;
+    remaining: number;
+}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/src/wrap.d.ts

@@ -0,0 +1,4 @@
+/** Wraps bot response text in an AdaptiveCard with inline feedback buttons. */
+export declare function wrapWithFeedbackButtons(text: string): object;
+/** Wraps an AdaptiveCard JSON object in a bot attachment envelope. */
+export declare function createCardAttachment(card: object): object;

package/dist/src/wrap.js

@@ -0,0 +1,13 @@
+import { buildInlineButtons } from './cards/inlineButtons.js';
+/** Wraps bot response text in an AdaptiveCard with inline feedback buttons. */
+export function wrapWithFeedbackButtons(text) {
+    return buildInlineButtons(text);
+}
+/** Wraps an AdaptiveCard JSON object in a bot attachment envelope. */
+export function createCardAttachment(card) {
+    return {
+        contentType: 'application/vnd.microsoft.card.adaptive',
+        content: card,
+    };
+}
+//# sourceMappingURL=wrap.js.map

package/dist/src/wrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap.js","sourceRoot":"","sources":["../../src/wrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,+EAA+E;AAC/E,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO;QACL,WAAW,EAAE,yCAAyC;QACtD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@journai/feedback-core",
+  "version": "0.1.0",
+  "description": "SDK-agnostic feedback flow core for AI agent bots",
+  "type": "module",
+  "files": ["dist"],
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/src/index.js",
+      "types": "./dist/src/index.d.ts"
+    },
+    "./cards": {
+      "import": "./dist/src/cards/index.js",
+      "types": "./dist/src/cards/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}