@myapihq/sdk 2.19.2 → 2.20.0

package/dist/feedback.d.ts

@@ -154,3 +154,16 @@ export interface WidgetUpdate {
 export declare function updateWidget(apiKey: string, orgId: string, id: string, patch: WidgetUpdate): Promise<Widget>;
 export declare function listWidgets(apiKey: string, orgId: string): Promise<Widget[]>;
 export declare function revokeWidget(apiKey: string, orgId: string, id: string): Promise<void>;
+/**
+ * Render a feedback item as a Playwright spec.
+ *
+ * Returns the spec SOURCE, not JSON: the endpoint answers `text/plain`, so this
+ * cannot go through `request()`, which parses every body as JSON and would
+ * throw `invalid_json_response` on a perfectly good test file.
+ *
+ * `base` overrides where the test runs. The report's own `page_url` is used by
+ * default; an item filed without one answers 422 `BASE_URL_REQUIRED`, because
+ * the generator has nowhere to point the browser and guessing would produce a
+ * spec that silently tests nothing.
+ */
+export declare function getItemTest(apiKey: string, orgId: string, id: string, base?: string): Promise<string>;

package/dist/feedback.js

@@ -9,6 +9,7 @@ exports.createWidget = createWidget;
 exports.updateWidget = updateWidget;
 exports.listWidgets = listWidgets;
 exports.revokeWidget = revokeWidget;
+exports.getItemTest = getItemTest;
 const client_1 = require("./client");
 const config_1 = require("./config");
 // End-user feedback collected from a page, and the widget keys that let a
@@ -22,6 +23,8 @@ exports.EXPOSES = [
     'POST /feedback/orgs/{org_id}/items',
     'POST /feedback/orgs/{org_id}/items/{id}/resolve',
     'DELETE /feedback/orgs/{org_id}/items/{id}',
+    // Answers text/plain — a Playwright spec, not the JSON envelope.
+    'GET /feedback/orgs/{org_id}/items/{id}/test',
 ];
 function orgBase(orgId) {
     return `${config_1.FEEDBACK_BASE}/feedback/orgs/${encodeURIComponent(orgId)}`;
@@ -92,3 +95,33 @@ async function listWidgets(apiKey, orgId) {
 async function revokeWidget(apiKey, orgId, id) {
     return (0, client_1.request)('DELETE', `${orgBase(orgId)}/widgets/${encodeURIComponent(id)}`, apiKey);
 }
+/**
+ * Render a feedback item as a Playwright spec.
+ *
+ * Returns the spec SOURCE, not JSON: the endpoint answers `text/plain`, so this
+ * cannot go through `request()`, which parses every body as JSON and would
+ * throw `invalid_json_response` on a perfectly good test file.
+ *
+ * `base` overrides where the test runs. The report's own `page_url` is used by
+ * default; an item filed without one answers 422 `BASE_URL_REQUIRED`, because
+ * the generator has nowhere to point the browser and guessing would produce a
+ * spec that silently tests nothing.
+ */
+async function getItemTest(apiKey, orgId, id, base) {
+    const qs = base ? `?base=${encodeURIComponent(base)}` : '';
+    const url = `${orgBase(orgId)}/items/${encodeURIComponent(id)}/test${qs}`;
+    const response = await fetch(url, { headers: { Authorization: `Bearer ${apiKey}` } });
+    const raw = await response.text();
+    if (!response.ok) {
+        // Errors still come back as the JSON envelope, so parse only on failure.
+        let err;
+        try {
+            err = JSON.parse(raw)?.error;
+        }
+        catch { /* fall through to the code below */ }
+        const code = typeof err === 'object' ? (err?.code ?? 'unknown_error') : (err ?? 'unknown_error');
+        const detail = typeof err === 'object' ? err?.message : undefined;
+        throw new client_1.MyApiError(code, response.status, detail, typeof err === 'object' ? err : undefined);
+    }
+    return raw;
+}

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.19.2";
+export declare const SDK_VERSION = "2.20.0";

package/dist/version.js

@@ -8,4 +8,4 @@ exports.SDK_VERSION = void 0;
 // Why a constant and not a package.json read: the SDK runs inside edge
 // functions (Cloudflare Workers), so it must not import node:fs. A literal
 // is the only version source that works in every runtime we ship to.
-exports.SDK_VERSION = '2.19.2';
+exports.SDK_VERSION = '2.20.0';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@myapihq/sdk",
   "license": "Apache-2.0",
-  "version": "2.19.2",
+  "version": "2.20.0",
   "description": "TypeScript SDK for the MyAPI ecosystem",
   "repository": {
     "type": "git",