@shakenbake/linear 0.0.1

package/dist/adapter.js

@@ -0,0 +1,237 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// @shakenbake/linear — LinearAdapter implementing DestinationAdapter
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LinearAdapter = void 0;
+const core_1 = require("@shakenbake/core");
+const types_js_1 = require("./types.js");
+const graphql_js_1 = require("./graphql.js");
+const markdown_js_1 = require("./markdown.js");
+/**
+ * Linear destination adapter.
+ *
+ * Creates issues in Linear via the GraphQL API with markdown descriptions,
+ * embedded screenshots, and full device context.
+ */
+class LinearAdapter {
+    name = 'linear';
+    config;
+    apiUrl;
+    severityMapping;
+    constructor(config) {
+        this.config = config;
+        this.apiUrl = config.apiUrl ?? types_js_1.DEFAULT_API_URL;
+        this.severityMapping = config.severityMapping ?? types_js_1.DEFAULT_SEVERITY_MAPPING;
+    }
+    /**
+     * Upload an image to Linear via the two-step file upload flow:
+     * 1. Call fileUpload mutation to get a signed upload URL and asset URL
+     * 2. PUT the image data to the signed URL with headers from response
+     * 3. Return the asset URL for embedding in the issue
+     *
+     * @throws {ShakeNbakeError} with code UPLOAD_FAILED on failure
+     */
+    async uploadImage(imageData, filename) {
+        const size = imageData instanceof Blob ? imageData.size : imageData.byteLength;
+        const contentType = LinearAdapter.detectContentType(filename);
+        // Step 1: Request a signed upload URL from Linear
+        let uploadUrl;
+        let assetUrl;
+        let uploadHeaders;
+        try {
+            const result = await (0, graphql_js_1.requestUploadUrl)(this.config.apiKey, this.apiUrl, filename, contentType, size);
+            uploadUrl = result.uploadUrl;
+            assetUrl = result.assetUrl;
+            uploadHeaders = result.headers;
+        }
+        catch (error) {
+            if (error instanceof core_1.ShakeNbakeError) {
+                throw error;
+            }
+            throw new core_1.ShakeNbakeError('Failed to initiate file upload to Linear', 'UPLOAD_FAILED', { originalError: error });
+        }
+        // Step 2: PUT the image data to the signed URL
+        try {
+            // Convert Buffer to Blob for fetch body compatibility across environments
+            const body = imageData instanceof Blob
+                ? imageData
+                : new Blob([new Uint8Array(imageData)], { type: contentType });
+            // Build headers: Content-Type + Cache-Control + any headers from Linear
+            const putHeaders = {
+                'Content-Type': contentType,
+                'Cache-Control': 'public, max-age=31536000',
+            };
+            // Apply additional headers returned by the fileUpload mutation
+            for (const header of uploadHeaders) {
+                putHeaders[header.key] = header.value;
+            }
+            const putResponse = await fetch(uploadUrl, {
+                method: 'PUT',
+                headers: putHeaders,
+                body,
+            });
+            if (!putResponse.ok) {
+                throw new core_1.ShakeNbakeError(`File upload to Linear storage failed (HTTP ${String(putResponse.status)})`, 'UPLOAD_FAILED', { retryable: false });
+            }
+        }
+        catch (error) {
+            if (error instanceof core_1.ShakeNbakeError) {
+                throw error;
+            }
+            throw new core_1.ShakeNbakeError('Network error during file upload to Linear storage', 'UPLOAD_FAILED', { originalError: error });
+        }
+        return assetUrl;
+    }
+    /**
+     * Detect the content type from a filename extension.
+     */
+    static detectContentType(filename) {
+        const lower = filename.toLowerCase();
+        if (lower.endsWith('.png'))
+            return 'image/png';
+        if (lower.endsWith('.jpg') || lower.endsWith('.jpeg'))
+            return 'image/jpeg';
+        if (lower.endsWith('.gif'))
+            return 'image/gif';
+        if (lower.endsWith('.webp'))
+            return 'image/webp';
+        if (lower.endsWith('.webm'))
+            return 'audio/webm';
+        if (lower.endsWith('.m4a'))
+            return 'audio/m4a';
+        if (lower.endsWith('.svg'))
+            return 'image/svg+xml';
+        return 'application/octet-stream';
+    }
+    /**
+     * Create a Linear issue from a BugReport.
+     *
+     * Uploads screenshots, builds a markdown description, and creates the issue
+     * via the issueCreate GraphQL mutation.
+     *
+     * @throws {ShakeNbakeError} with appropriate code on failure
+     */
+    async createIssue(report) {
+        // Upload screenshots
+        let annotatedUrl;
+        let originalUrl;
+        let audioUrl;
+        try {
+            annotatedUrl = await this.uploadImage(base64ToBuffer(report.screenshot.annotated), `screenshot-annotated-${report.id}.png`);
+        }
+        catch {
+            // Fall back to embedding base64 inline if upload fails
+            annotatedUrl = undefined;
+        }
+        try {
+            originalUrl = await this.uploadImage(base64ToBuffer(report.screenshot.original), `screenshot-original-${report.id}.png`);
+        }
+        catch {
+            originalUrl = undefined;
+        }
+        // Upload audio if present
+        if (report.audio?.data) {
+            try {
+                const ext = report.audio.mimeType.includes('webm') ? 'webm' : 'm4a';
+                audioUrl = await this.uploadImage(base64ToBuffer(report.audio.data), `audio-${report.id}.${ext}`);
+            }
+            catch {
+                audioUrl = undefined;
+            }
+        }
+        // Build markdown description
+        const description = (0, markdown_js_1.buildIssueDescription)(report, annotatedUrl, originalUrl, audioUrl);
+        // Determine priority
+        const priority = this.resolvePriority(report.severity);
+        // Build label IDs
+        const labelIds = this.resolveLabelIds(report.category);
+        // Build input
+        const input = {
+            title: report.title,
+            description,
+            teamId: this.config.teamId,
+        };
+        if (this.config.projectId) {
+            input['projectId'] = this.config.projectId;
+        }
+        if (labelIds.length > 0) {
+            input['labelIds'] = labelIds;
+        }
+        if (this.config.defaultAssigneeId) {
+            input['assigneeId'] = this.config.defaultAssigneeId;
+        }
+        if (priority !== undefined) {
+            input['priority'] = priority;
+        }
+        // Create issue
+        const data = await (0, graphql_js_1.linearFetch)(this.config.apiKey, this.apiUrl, graphql_js_1.ISSUE_CREATE_MUTATION, { input });
+        if (!data.issueCreate.success) {
+            throw new core_1.ShakeNbakeError('Linear issue creation returned success=false', 'UNKNOWN', { retryable: false });
+        }
+        return {
+            url: data.issueCreate.issue.url,
+            id: data.issueCreate.issue.id,
+            success: true,
+        };
+    }
+    /**
+     * Test the connection to Linear by querying the authenticated user.
+     *
+     * @returns true if credentials are valid, false if auth fails
+     * @throws {ShakeNbakeError} with NETWORK_ERROR for connectivity issues
+     */
+    async testConnection() {
+        try {
+            const data = await (0, graphql_js_1.linearFetch)(this.config.apiKey, this.apiUrl, graphql_js_1.VIEWER_QUERY);
+            return Boolean(data.viewer?.id);
+        }
+        catch (error) {
+            if (error instanceof core_1.ShakeNbakeError) {
+                if (error.code === 'AUTH_FAILED') {
+                    return false;
+                }
+                throw error;
+            }
+            throw new core_1.ShakeNbakeError('Failed to test Linear connection', 'NETWORK_ERROR', { originalError: error });
+        }
+    }
+    /**
+     * Resolve the Linear priority from a severity string.
+     */
+    resolvePriority(severity) {
+        const mapped = this.severityMapping[severity];
+        if (mapped !== undefined) {
+            return mapped;
+        }
+        return this.config.defaultPriority;
+    }
+    /**
+     * Resolve label IDs from default labels + category-based labels.
+     */
+    resolveLabelIds(category) {
+        const ids = [];
+        if (this.config.defaultLabelIds) {
+            ids.push(...this.config.defaultLabelIds);
+        }
+        if (this.config.categoryLabels) {
+            const categoryLabel = this.config.categoryLabels[category];
+            if (categoryLabel) {
+                ids.push(categoryLabel);
+            }
+        }
+        return ids;
+    }
+}
+exports.LinearAdapter = LinearAdapter;
+/**
+ * Convert a base64-encoded string to a Buffer.
+ * Strips the data URI prefix if present.
+ */
+function base64ToBuffer(base64) {
+    // Remove data URI prefix if present (e.g., "data:image/png;base64,")
+    const commaIndex = base64.indexOf(',');
+    const raw = commaIndex >= 0 ? base64.substring(commaIndex + 1) : base64;
+    return Buffer.from(raw, 'base64');
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,qEAAqE;AACrE,8EAA8E;;;AAO9E,2CAAmD;AAEnD,yCAGoB;AACpB,6CAKsB;AAKtB,+CAAsD;AAEtD;;;;;GAKG;AACH,MAAa,aAAa;IACf,IAAI,GAAG,QAAQ,CAAC;IAER,MAAM,CAAe;IACrB,MAAM,CAAS;IACf,eAAe,CAAyB;IAEzD,YAAY,MAAoB;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,0BAAe,CAAC;QAC/C,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,mCAAwB,CAAC;IAC5E,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,WAAW,CACf,SAAwB,EACxB,QAAgB;QAEhB,MAAM,IAAI,GACR,SAAS,YAAY,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC;QAEpE,MAAM,WAAW,GAAG,aAAa,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAE9D,kDAAkD;QAClD,IAAI,SAAiB,CAAC;QACtB,IAAI,QAAgB,CAAC;QACrB,IAAI,aAAoD,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAA,6BAAgB,EACnC,IAAI,CAAC,MAAM,CAAC,MAAM,EAClB,IAAI,CAAC,MAAM,EACX,QAAQ,EACR,WAAW,EACX,IAAI,CACL,CAAC;YACF,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;YAC7B,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;YAC3B,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC;QACjC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,sBAAe,EAAE,CAAC;gBACrC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,IAAI,sBAAe,CACvB,0CAA0C,EAC1C,eAAe,EACf,EAAE,aAAa,EAAE,KAAK,EAAE,CACzB,CAAC;QACJ,CAAC;QAED,+CAA+C;QAC/C,IAAI,CAAC;YACH,0EAA0E;YAC1E,MAAM,IAAI,GACR,SAAS,YAAY,IAAI;gBACvB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;YAEnE,wEAAwE;YACxE,MAAM,UAAU,GAA2B;gBACzC,cAAc,EAAE,WAAW;gBAC3B,eAAe,EAAE,0BAA0B;aAC5C,CAAC;YAEF,+DAA+D;YAC/D,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;gBACnC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;YACxC,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE;gBACzC,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,UAAU;gBACnB,IAAI;aACL,CAAC,CAAC;YAEH,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC;gBACpB,MAAM,IAAI,sBAAe,CACvB,8CAA8C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,EAC3E,eAAe,EACf,EAAE,SAAS,EAAE,KAAK,EAAE,CACrB,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,sBAAe,EAAE,CAAC;gBACrC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,IAAI,sBAAe,CACvB,oDAAoD,EACpD,eAAe,EACf,EAAE,aAAa,EAAE,KAAK,EAAE,CACzB,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAgB;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,WAAW,CAAC;QAC/C,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,YAAY,CAAC;QAC3E,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,WAAW,CAAC;QAC/C,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,YAAY,CAAC;QACjD,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,YAAY,CAAC;QACjD,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,WAAW,CAAC;QAC/C,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,eAAe,CAAC;QACnD,OAAO,0BAA0B,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,WAAW,CAAC,MAAiB;QACjC,qBAAqB;QACrB,IAAI,YAAgC,CAAC;QACrC,IAAI,WAA+B,CAAC;QACpC,IAAI,QAA4B,CAAC;QAEjC,IAAI,CAAC;YACH,YAAY,GAAG,MAAM,IAAI,CAAC,WAAW,CACnC,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,EAC3C,wBAAwB,MAAM,CAAC,EAAE,MAAM,CACxC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;YACvD,YAAY,GAAG,SAAS,CAAC;QAC3B,CAAC;QAED,IAAI,CAAC;YACH,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAClC,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAC1C,uBAAuB,MAAM,CAAC,EAAE,MAAM,CACvC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,WAAW,GAAG,SAAS,CAAC;QAC1B,CAAC;QAED,0BAA0B;QAC1B,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;gBACpE,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAC/B,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EACjC,SAAS,MAAM,CAAC,EAAE,IAAI,GAAG,EAAE,CAC5B,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,QAAQ,GAAG,SAAS,CAAC;YACvB,CAAC;QACH,CAAC;QAED,6BAA6B;QAC7B,MAAM,WAAW,GAAG,IAAA,mCAAqB,EACvC,MAAM,EACN,YAAY,EACZ,WAAW,EACX,QAAQ,CACT,CAAC;QAEF,qBAAqB;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEvD,kBAAkB;QAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEvD,cAAc;QACd,MAAM,KAAK,GAA4B;YACrC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW;YACX,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;SAC3B,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC1B,KAAK,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QAC7C,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC;QAC/B,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAClC,KAAK,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC;QACtD,CAAC;QAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,KAAK,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC;QAC/B,CAAC;QAED,eAAe;QACf,MAAM,IAAI,GAAG,MAAM,IAAA,wBAAW,EAC5B,IAAI,CAAC,MAAM,CAAC,MAAM,EAClB,IAAI,CAAC,MAAM,EACX,kCAAqB,EACrB,EAAE,KAAK,EAAE,CACV,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,sBAAe,CACvB,8CAA8C,EAC9C,SAAS,EACT,EAAE,SAAS,EAAE,KAAK,EAAE,CACrB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG;YAC/B,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE;YAC7B,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc;QAClB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAA,wBAAW,EAC5B,IAAI,CAAC,MAAM,CAAC,MAAM,EAClB,IAAI,CAAC,MAAM,EACX,yBAAY,CACb,CAAC;YACF,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,sBAAe,EAAE,CAAC;gBACrC,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;oBACjC,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,IAAI,sBAAe,CACvB,kCAAkC,EAClC,eAAe,EACf,EAAE,aAAa,EAAE,KAAK,EAAE,CACzB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,QAAgB;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;IACrC,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,QAAgB;QACtC,MAAM,GAAG,GAAa,EAAE,CAAC;QAEzB,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YAChC,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC/B,MAAM,aAAa,GACjB,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,QAAmD,CAAC,CAAC;YAClF,IAAI,aAAa,EAAE,CAAC;gBAClB,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AA3RD,sCA2RC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,MAAc;IACpC,qEAAqE;IACrE,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACxE,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC"}

package/dist/graphql.d.ts

@@ -0,0 +1,64 @@
+export declare const VIEWER_QUERY = "\n  query Viewer {\n    viewer {\n      id\n    }\n  }\n";
+export declare const ISSUE_CREATE_MUTATION = "\n  mutation IssueCreate($input: IssueCreateInput!) {\n    issueCreate(input: $input) {\n      success\n      issue {\n        id\n        identifier\n        title\n        url\n      }\n    }\n  }\n";
+export declare const FILE_UPLOAD_MUTATION = "\n  mutation FileUpload($size: Int!, $contentType: String!, $filename: String!) {\n    fileUpload(size: $size, contentType: $contentType, filename: $filename) {\n      success\n      uploadFile {\n        uploadUrl\n        assetUrl\n        headers {\n          key\n          value\n        }\n      }\n    }\n  }\n";
+export interface GraphQLResponse<T = unknown> {
+    data?: T;
+    errors?: Array<{
+        message: string;
+        extensions?: Record<string, unknown>;
+    }>;
+}
+export interface ViewerData {
+    viewer: {
+        id: string;
+    };
+}
+export interface IssueCreateData {
+    issueCreate: {
+        success: boolean;
+        issue: {
+            id: string;
+            identifier: string;
+            title: string;
+            url: string;
+        };
+    };
+}
+export interface FileUploadHeader {
+    key: string;
+    value: string;
+}
+export interface FileUploadData {
+    fileUpload: {
+        success: boolean;
+        uploadFile: {
+            uploadUrl: string;
+            assetUrl: string;
+            headers: FileUploadHeader[];
+        };
+    };
+}
+/**
+ * Result of requesting an upload URL from Linear.
+ */
+export interface UploadUrlResult {
+    uploadUrl: string;
+    assetUrl: string;
+    headers: FileUploadHeader[];
+}
+/**
+ * Request a signed upload URL from Linear's fileUpload mutation.
+ *
+ * @throws {ShakeNbakeError} on failure
+ */
+export declare function requestUploadUrl(apiKey: string, apiUrl: string, filename: string, contentType: string, size: number): Promise<UploadUrlResult>;
+/**
+ * Execute a GraphQL request against the Linear API.
+ *
+ * Authorization header uses the API key directly (no "Bearer" prefix),
+ * matching Linear's expected format.
+ *
+ * @throws {ShakeNbakeError} with appropriate code on failure
+ */
+export declare function linearFetch<T = unknown>(apiKey: string, apiUrl: string, query: string, variables?: Record<string, unknown>): Promise<T>;
+//# sourceMappingURL=graphql.d.ts.map

package/dist/graphql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../src/graphql.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,YAAY,6DAMxB,CAAC;AAEF,eAAO,MAAM,qBAAqB,6MAYjC,CAAC;AAEF,eAAO,MAAM,oBAAoB,kUAchC,CAAC;AAIF,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE;YACL,EAAE,EAAE,MAAM,CAAC;YACX,UAAU,EAAE,MAAM,CAAC;YACnB,KAAK,EAAE,MAAM,CAAC;YACd,GAAG,EAAE,MAAM,CAAC;SACb,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE;YACV,SAAS,EAAE,MAAM,CAAC;YAClB,QAAQ,EAAE,MAAM,CAAC;YACjB,OAAO,EAAE,gBAAgB,EAAE,CAAC;SAC7B,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,CAAC,CAkB1B;AAID;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,CAAC,GAAG,OAAO,EAC3C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,CAAC,CAAC,CAgGZ"}

package/dist/graphql.js

@@ -0,0 +1,120 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// @shakenbake/linear — GraphQL queries, mutations, and fetch wrapper
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FILE_UPLOAD_MUTATION = exports.ISSUE_CREATE_MUTATION = exports.VIEWER_QUERY = void 0;
+exports.requestUploadUrl = requestUploadUrl;
+exports.linearFetch = linearFetch;
+const core_1 = require("@shakenbake/core");
+// ---- GraphQL Queries & Mutations ----
+exports.VIEWER_QUERY = `
+  query Viewer {
+    viewer {
+      id
+    }
+  }
+`;
+exports.ISSUE_CREATE_MUTATION = `
+  mutation IssueCreate($input: IssueCreateInput!) {
+    issueCreate(input: $input) {
+      success
+      issue {
+        id
+        identifier
+        title
+        url
+      }
+    }
+  }
+`;
+exports.FILE_UPLOAD_MUTATION = `
+  mutation FileUpload($size: Int!, $contentType: String!, $filename: String!) {
+    fileUpload(size: $size, contentType: $contentType, filename: $filename) {
+      success
+      uploadFile {
+        uploadUrl
+        assetUrl
+        headers {
+          key
+          value
+        }
+      }
+    }
+  }
+`;
+/**
+ * Request a signed upload URL from Linear's fileUpload mutation.
+ *
+ * @throws {ShakeNbakeError} on failure
+ */
+async function requestUploadUrl(apiKey, apiUrl, filename, contentType, size) {
+    const data = await linearFetch(apiKey, apiUrl, exports.FILE_UPLOAD_MUTATION, { size, contentType, filename });
+    if (!data.fileUpload.success) {
+        throw new core_1.ShakeNbakeError('Linear fileUpload mutation returned success=false', 'UPLOAD_FAILED', { retryable: false });
+    }
+    const { uploadUrl, assetUrl, headers } = data.fileUpload.uploadFile;
+    return { uploadUrl, assetUrl, headers };
+}
+// ---- Fetch Wrapper ----
+/**
+ * Execute a GraphQL request against the Linear API.
+ *
+ * Authorization header uses the API key directly (no "Bearer" prefix),
+ * matching Linear's expected format.
+ *
+ * @throws {ShakeNbakeError} with appropriate code on failure
+ */
+async function linearFetch(apiKey, apiUrl, query, variables) {
+    let response;
+    try {
+        response = await fetch(apiUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: apiKey,
+            },
+            body: JSON.stringify({ query, variables }),
+        });
+    }
+    catch (error) {
+        throw new core_1.ShakeNbakeError('Network request to Linear API failed', 'NETWORK_ERROR', { originalError: error });
+    }
+    // Handle HTTP-level errors
+    if (response.status === 401 || response.status === 403) {
+        throw new core_1.ShakeNbakeError(`Linear API authentication failed (HTTP ${String(response.status)})`, 'AUTH_FAILED', { retryable: false });
+    }
+    if (response.status === 429) {
+        throw new core_1.ShakeNbakeError('Linear API rate limit exceeded', 'RATE_LIMITED', { retryable: true });
+    }
+    if (!response.ok) {
+        throw new core_1.ShakeNbakeError(`Linear API request failed (HTTP ${String(response.status)})`, 'UNKNOWN', { retryable: false });
+    }
+    let json;
+    try {
+        json = (await response.json());
+    }
+    catch (error) {
+        throw new core_1.ShakeNbakeError('Failed to parse Linear API response', 'UNKNOWN', { originalError: error });
+    }
+    // Handle GraphQL-level errors
+    if (json.errors && json.errors.length > 0) {
+        const firstError = json.errors[0];
+        const message = firstError?.message ?? 'Unknown GraphQL error';
+        // Check if the error indicates rate limiting via extensions.code
+        const extensionCode = firstError?.extensions?.['code'];
+        if (extensionCode === 'RATELIMITED') {
+            throw new core_1.ShakeNbakeError(`Linear API rate limit exceeded: ${message}`, 'RATE_LIMITED', { retryable: true });
+        }
+        // Check if the error indicates auth failure
+        if (message.toLowerCase().includes('authentication')) {
+            throw new core_1.ShakeNbakeError(`Linear GraphQL error: ${message}`, 'AUTH_FAILED', { retryable: false });
+        }
+        throw new core_1.ShakeNbakeError(`Linear GraphQL error: ${message}`, 'UNKNOWN', { retryable: false });
+    }
+    if (!json.data) {
+        throw new core_1.ShakeNbakeError('Linear API returned empty response', 'UNKNOWN', { retryable: false });
+    }
+    return json.data;
+}
+//# sourceMappingURL=graphql.js.map

package/dist/graphql.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { LinearAdapter } from './adapter.js';
+export type { LinearConfig } from './types.js';
+export { DEFAULT_SEVERITY_MAPPING, DEFAULT_API_URL } from './types.js';
+export { linearFetch, requestUploadUrl, VIEWER_QUERY, ISSUE_CREATE_MUTATION, FILE_UPLOAD_MUTATION, } from './graphql.js';
+export type { GraphQLResponse, ViewerData, IssueCreateData, FileUploadData, FileUploadHeader, UploadUrlResult, } from './graphql.js';
+export { buildIssueDescription } from './markdown.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGvE,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,eAAe,EACf,UAAU,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// @shakenbake/linear — Public API
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildIssueDescription = exports.FILE_UPLOAD_MUTATION = exports.ISSUE_CREATE_MUTATION = exports.VIEWER_QUERY = exports.requestUploadUrl = exports.linearFetch = exports.DEFAULT_API_URL = exports.DEFAULT_SEVERITY_MAPPING = exports.LinearAdapter = void 0;
+// Adapter
+var adapter_js_1 = require("./adapter.js");
+Object.defineProperty(exports, "LinearAdapter", { enumerable: true, get: function () { return adapter_js_1.LinearAdapter; } });
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "DEFAULT_SEVERITY_MAPPING", { enumerable: true, get: function () { return types_js_1.DEFAULT_SEVERITY_MAPPING; } });
+Object.defineProperty(exports, "DEFAULT_API_URL", { enumerable: true, get: function () { return types_js_1.DEFAULT_API_URL; } });
+// GraphQL (exported for advanced use / testing)
+var graphql_js_1 = require("./graphql.js");
+Object.defineProperty(exports, "linearFetch", { enumerable: true, get: function () { return graphql_js_1.linearFetch; } });
+Object.defineProperty(exports, "requestUploadUrl", { enumerable: true, get: function () { return graphql_js_1.requestUploadUrl; } });
+Object.defineProperty(exports, "VIEWER_QUERY", { enumerable: true, get: function () { return graphql_js_1.VIEWER_QUERY; } });
+Object.defineProperty(exports, "ISSUE_CREATE_MUTATION", { enumerable: true, get: function () { return graphql_js_1.ISSUE_CREATE_MUTATION; } });
+Object.defineProperty(exports, "FILE_UPLOAD_MUTATION", { enumerable: true, get: function () { return graphql_js_1.FILE_UPLOAD_MUTATION; } });
+// Markdown builder (exported for customization)
+var markdown_js_1 = require("./markdown.js");
+Object.defineProperty(exports, "buildIssueDescription", { enumerable: true, get: function () { return markdown_js_1.buildIssueDescription; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;;;AAE9E,UAAU;AACV,2CAA6C;AAApC,2GAAA,aAAa,OAAA;AAItB,uCAAuE;AAA9D,oHAAA,wBAAwB,OAAA;AAAE,2GAAA,eAAe,OAAA;AAElD,gDAAgD;AAChD,2CAMsB;AALpB,yGAAA,WAAW,OAAA;AACX,8GAAA,gBAAgB,OAAA;AAChB,0GAAA,YAAY,OAAA;AACZ,mHAAA,qBAAqB,OAAA;AACrB,kHAAA,oBAAoB,OAAA;AAWtB,gDAAgD;AAChD,6CAAsD;AAA7C,oHAAA,qBAAqB,OAAA"}

package/dist/markdown.d.ts

@@ -0,0 +1,8 @@
+import type { BugReport } from '@shakenbake/core';
+/**
+ * Build a formatted Markdown description for a Linear issue from a BugReport.
+ *
+ * Missing context fields are gracefully omitted (never shown as "undefined").
+ */
+export declare function buildIssueDescription(report: BugReport, screenshotUrl?: string, originalScreenshotUrl?: string, audioUrl?: string): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,kBAAkB,CAAC;AAEjE;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,aAAa,CAAC,EAAE,MAAM,EACtB,qBAAqB,CAAC,EAAE,MAAM,EAC9B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAqER"}

package/dist/markdown.js

@@ -0,0 +1,165 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// @shakenbake/linear — Markdown description builder for Linear issues
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildIssueDescription = buildIssueDescription;
+/**
+ * Build a formatted Markdown description for a Linear issue from a BugReport.
+ *
+ * Missing context fields are gracefully omitted (never shown as "undefined").
+ */
+function buildIssueDescription(report, screenshotUrl, originalScreenshotUrl, audioUrl) {
+    const sections = [];
+    // Header
+    sections.push('## Bug Report');
+    sections.push('');
+    sections.push(report.description);
+    sections.push('');
+    // Audio transcript (if available)
+    if (report.audio?.transcript) {
+        sections.push('### Audio Transcript');
+        sections.push('');
+        sections.push(report.audio.transcript);
+        sections.push('');
+    }
+    // Screenshots
+    sections.push('### Screenshots');
+    sections.push('');
+    if (screenshotUrl) {
+        sections.push('**Annotated:**');
+        sections.push(`![Annotated screenshot](${screenshotUrl})`);
+        sections.push('');
+    }
+    if (originalScreenshotUrl) {
+        sections.push('**Original:**');
+        sections.push(`![Original screenshot](${originalScreenshotUrl})`);
+        sections.push('');
+    }
+    // Audio attachment link
+    if (audioUrl) {
+        sections.push(`**Audio recording:** [Listen](${audioUrl})`);
+        sections.push('');
+    }
+    // Device context
+    const contextTable = buildContextTable(report.context);
+    if (contextTable) {
+        sections.push('### Device Context');
+        sections.push('');
+        sections.push('<details>');
+        sections.push('<summary>Full device and environment details</summary>');
+        sections.push('');
+        sections.push('| Field | Value |');
+        sections.push('|---|---|');
+        sections.push(contextTable);
+        sections.push('');
+        sections.push('</details>');
+        sections.push('');
+    }
+    // Console errors
+    const consoleErrors = buildConsoleErrors(report.context);
+    if (consoleErrors) {
+        sections.push('### Console Errors (last 5)');
+        sections.push('');
+        sections.push(consoleErrors);
+        sections.push('');
+    }
+    // Footer
+    sections.push('---');
+    sections.push('*Reported via [ShakeNbake](https://github.com/user/shakenbake)*');
+    return sections.join('\n');
+}
+/**
+ * Build a Markdown table of device context fields.
+ * Only includes fields that have values.
+ */
+function buildContextTable(context) {
+    const rows = [];
+    // Platform
+    const { platform } = context;
+    if (platform.os) {
+        const osDisplay = platform.osVersion
+            ? `${platform.os} ${platform.osVersion}`
+            : platform.os;
+        rows.push(`| Platform | ${osDisplay} |`);
+    }
+    if (platform.userAgent) {
+        rows.push(`| User Agent | ${platform.userAgent} |`);
+    }
+    if (platform.browser) {
+        rows.push(`| Browser | ${platform.browser} |`);
+    }
+    // Device
+    const { device } = context;
+    const deviceParts = [device.manufacturer, device.model].filter(Boolean);
+    if (deviceParts.length > 0) {
+        rows.push(`| Device | ${deviceParts.join(' ')} |`);
+    }
+    // Screen
+    const { screen } = context;
+    if (screen.width && screen.height) {
+        const scaleStr = screen.scale ? ` @${String(screen.scale)}x` : '';
+        rows.push(`| Screen | ${String(screen.width)}x${String(screen.height)}${scaleStr} |`);
+    }
+    // Network
+    const { network } = context;
+    const networkParts = [];
+    if (network.type)
+        networkParts.push(network.type);
+    if (network.effectiveType)
+        networkParts.push(`(${network.effectiveType})`);
+    if (networkParts.length > 0) {
+        rows.push(`| Network | ${networkParts.join(' ')} |`);
+    }
+    // Battery
+    const { battery } = context;
+    if (battery.level !== undefined) {
+        const stateStr = battery.state ? ` (${battery.state})` : '';
+        rows.push(`| Battery | ${String(battery.level)}%${stateStr} |`);
+    }
+    // Locale
+    const { locale } = context;
+    const localeParts = [locale.languageCode, locale.regionCode].filter(Boolean);
+    if (localeParts.length > 0) {
+        rows.push(`| Locale | ${localeParts.join('-')} |`);
+    }
+    if (locale.timezone) {
+        rows.push(`| Timezone | ${locale.timezone} |`);
+    }
+    // App
+    const { app } = context;
+    if (app.version) {
+        const buildStr = app.buildNumber ? ` (${app.buildNumber})` : '';
+        rows.push(`| App Version | ${app.version}${buildStr} |`);
+    }
+    if (app.url) {
+        rows.push(`| URL | ${app.url} |`);
+    }
+    // Navigation
+    const { navigation } = context;
+    if (navigation.currentRoute) {
+        rows.push(`| Current Route | ${navigation.currentRoute} |`);
+    }
+    return rows.join('\n');
+}
+/**
+ * Build a Markdown section for console errors (last 5).
+ */
+function buildConsoleErrors(context) {
+    const errors = context.console.recentErrors;
+    if (!errors || errors.length === 0) {
+        return null;
+    }
+    const last5 = errors.slice(-5);
+    const formatted = last5.map((err) => {
+        const lines = [`\`\`\``, err.message];
+        if (err.stack) {
+            lines.push(err.stack);
+        }
+        lines.push(`\`\`\``);
+        lines.push(`_${err.timestamp}_`);
+        return lines.join('\n');
+    });
+    return formatted.join('\n\n');
+}
+//# sourceMappingURL=markdown.js.map