x-twitter-scraper 0.5.0 → 0.5.1

package/resources/compose.js

@@ -8,14 +8,17 @@ const resource_1 = require("../core/resource.js");
  */
 class Compose extends resource_1.APIResource {
     /**
-     * Compose, refine, or score a tweet
+     * Run one step of Xquik's three-step writing workflow. Compose returns questions
+     * and editorial rules. Refine returns goal-specific guidance. Score applies
+     * deterministic text checks. It does not predict reach or expose X ranking
+     * weights.
      *
      * @example
      * ```ts
      * const compose = await client.compose.create({
      *   step: 'compose',
+     *   topic: 'PostgreSQL query planning',
      *   goal: 'engagement',
-     *   topic: 'AI trends in 2025',
      * });
      * ```
      */

package/resources/compose.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose.js","sourceRoot":"","sources":["../src/resources/compose.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C;;GAEG;AACH,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF;AAhBD,0BAgBC"}
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../src/resources/compose.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C;;GAEG;AACH,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF;AAnBD,0BAmBC"}

package/resources/compose.mjs

@@ -5,14 +5,17 @@ import { APIResource } from "../core/resource.mjs";
  */
 export class Compose extends APIResource {
     /**
-     * Compose, refine, or score a tweet
+     * Run one step of Xquik's three-step writing workflow. Compose returns questions
+     * and editorial rules. Refine returns goal-specific guidance. Score applies
+     * deterministic text checks. It does not predict reach or expose X ranking
+     * weights.
      *
      * @example
      * ```ts
      * const compose = await client.compose.create({
      *   step: 'compose',
+     *   topic: 'PostgreSQL query planning',
      *   goal: 'engagement',
-     *   topic: 'AI trends in 2025',
      * });
      * ```
      */

package/resources/compose.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"compose.mjs","sourceRoot":"","sources":["../src/resources/compose.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAI/C;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF"}
+{"version":3,"file":"compose.mjs","sourceRoot":"","sources":["../src/resources/compose.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAI/C;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/resources/monitors/keywords.d.mts

@@ -3,13 +3,13 @@ import * as Shared from "../shared.mjs";
 import { APIPromise } from "../../core/api-promise.mjs";
 import { RequestOptions } from "../../internal/request-options.mjs";
 /**
- * Real-time X account monitoring
+ * X account monitoring with 1-second checks
  */
 export declare class Keywords extends APIResource {
     /**
-     * Creates an instant keyword monitor. Keyword monitors are unlimited. Active
-     * monitors check every 1 second. Events and webhook deliveries are included.
-     * Creation requires an available usage balance.
+     * Creates a keyword monitor. Keyword monitors are unlimited. Active monitors check
+     * every 1 second and cost 21 credits per hour. Events and webhook deliveries are
+     * included. Creation requires available credits for the first hourly charge.
      *
      * @example
      * ```ts

package/resources/monitors/keywords.d.ts

@@ -3,13 +3,13 @@ import * as Shared from "../shared.js";
 import { APIPromise } from "../../core/api-promise.js";
 import { RequestOptions } from "../../internal/request-options.js";
 /**
- * Real-time X account monitoring
+ * X account monitoring with 1-second checks
  */
 export declare class Keywords extends APIResource {
     /**
-     * Creates an instant keyword monitor. Keyword monitors are unlimited. Active
-     * monitors check every 1 second. Events and webhook deliveries are included.
-     * Creation requires an available usage balance.
+     * Creates a keyword monitor. Keyword monitors are unlimited. Active monitors check
+     * every 1 second and cost 21 credits per hour. Events and webhook deliveries are
+     * included. Creation requires available credits for the first hourly charge.
      *
      * @example
      * ```ts

package/resources/monitors/keywords.js

@@ -5,13 +5,13 @@ exports.Keywords = void 0;
 const resource_1 = require("../../core/resource.js");
 const path_1 = require("../../internal/utils/path.js");
 /**
- * Real-time X account monitoring
+ * X account monitoring with 1-second checks
  */
 class Keywords extends resource_1.APIResource {
     /**
-     * Creates an instant keyword monitor. Keyword monitors are unlimited. Active
-     * monitors check every 1 second. Events and webhook deliveries are included.
-     * Creation requires an available usage balance.
+     * Creates a keyword monitor. Keyword monitors are unlimited. Active monitors check
+     * every 1 second and cost 21 credits per hour. Events and webhook deliveries are
+     * included. Creation requires available credits for the first hourly charge.
      *
      * @example
      * ```ts

package/resources/monitors/keywords.mjs

@@ -2,13 +2,13 @@
 import { APIResource } from "../../core/resource.mjs";
 import { path } from "../../internal/utils/path.mjs";
 /**
- * Real-time X account monitoring
+ * X account monitoring with 1-second checks
  */
 export class Keywords extends APIResource {
     /**
-     * Creates an instant keyword monitor. Keyword monitors are unlimited. Active
-     * monitors check every 1 second. Events and webhook deliveries are included.
-     * Creation requires an available usage balance.
+     * Creates a keyword monitor. Keyword monitors are unlimited. Active monitors check
+     * every 1 second and cost 21 credits per hour. Events and webhook deliveries are
+     * included. Creation requires available credits for the first hourly charge.
      *
      * @example
      * ```ts

package/resources/monitors/monitors.d.mts

@@ -5,14 +5,15 @@ import { KeywordCreateParams, KeywordCreateResponse, KeywordDeactivateResponse,
 import { APIPromise } from "../../core/api-promise.mjs";
 import { RequestOptions } from "../../internal/request-options.mjs";
 /**
- * Real-time X account monitoring
+ * X account monitoring with 1-second checks
  */
 export declare class Monitors extends APIResource {
     keywords: KeywordsAPI.Keywords;
     /**
-     * Creates an instant monitor. Monitors are unlimited. Active monitors check every
-     * 1 second. Events and webhook deliveries are included. Creation requires an
-     * available usage balance.
+     * Creates an account monitor. Monitors are unlimited. Active monitors check every
+     * 1 second and cost 21 credits per hour. Events and webhook deliveries are
+     * included. Creation requires available credits for the first hourly charge and
+     * username lookup.
      *
      * @example
      * ```ts

package/resources/monitors/monitors.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"monitors.d.mts","sourceRoot":"","sources":["../../src/resources/monitors/monitors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"monitors.d.mts","sourceRoot":"","sources":["../../src/resources/monitors/monitors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,MAAM,sBAAkB;AACpC,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,QAAQ,EACT,uBAAmB;AACpB,OAAO,EAAE,UAAU,EAAE,mCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE;;GAEG;AACH,qBAAa,QAAS,SAAQ,WAAW;IACvC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAA0C;IAExE;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;IAI9F;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAInE;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAI5F;;;;;;;OAOG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;IAI/D;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,yBAAyB,CAAC;CAGxF;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IAEX,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAEpC,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB,QAAQ,EAAE,MAAM,CAAC;IAEjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IAEX,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAEpC,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB,QAAQ,EAAE,MAAM,CAAC;IAEjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAEzB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAEpC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAErC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAID,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,OAAO,IAAI,OAAO,EACvB,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;IAEF,OAAO,EACL,QAAQ,IAAI,QAAQ,EACpB,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}

package/resources/monitors/monitors.d.ts

@@ -5,14 +5,15 @@ import { KeywordCreateParams, KeywordCreateResponse, KeywordDeactivateResponse,
 import { APIPromise } from "../../core/api-promise.js";
 import { RequestOptions } from "../../internal/request-options.js";
 /**
- * Real-time X account monitoring
+ * X account monitoring with 1-second checks
  */
 export declare class Monitors extends APIResource {
     keywords: KeywordsAPI.Keywords;
     /**
-     * Creates an instant monitor. Monitors are unlimited. Active monitors check every
-     * 1 second. Events and webhook deliveries are included. Creation requires an
-     * available usage balance.
+     * Creates an account monitor. Monitors are unlimited. Active monitors check every
+     * 1 second and cost 21 credits per hour. Events and webhook deliveries are
+     * included. Creation requires available credits for the first hourly charge and
+     * username lookup.
      *
      * @example
      * ```ts

package/resources/monitors/monitors.d.ts.map

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

package/resources/monitors/monitors.js

@@ -8,7 +8,7 @@ const KeywordsAPI = tslib_1.__importStar(require("./keywords.js"));
 const keywords_1 = require("./keywords.js");
 const path_1 = require("../../internal/utils/path.js");
 /**
- * Real-time X account monitoring
+ * X account monitoring with 1-second checks
  */
 class Monitors extends resource_1.APIResource {
     constructor() {
@@ -16,9 +16,10 @@ class Monitors extends resource_1.APIResource {
         this.keywords = new KeywordsAPI.Keywords(this._client);
     }
     /**
-     * Creates an instant monitor. Monitors are unlimited. Active monitors check every
-     * 1 second. Events and webhook deliveries are included. Creation requires an
-     * available usage balance.
+     * Creates an account monitor. Monitors are unlimited. Active monitors check every
+     * 1 second and cost 21 credits per hour. Events and webhook deliveries are
+     * included. Creation requires available credits for the first hourly charge and
+     * username lookup.
      *
      * @example
      * ```ts

package/resources/monitors/monitors.js.map

@@ -1 +1 @@
-{"version":3,"file":"monitors.js","sourceRoot":"","sources":["../../src/resources/monitors/monitors.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAElD,mEAA0C;AAC1C,4CASoB;AAGpB,uDAAiD;AAEjD;;GAEG;AACH,MAAa,QAAS,SAAQ,sBAAW;IAAzC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAqE1E,CAAC;IAnEC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAU,EAAE,IAAyB,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;OAOG;IACH,UAAU,CAAC,EAAU,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;CACF;AAtED,4BAsEC;AAgFD,QAAQ,CAAC,QAAQ,GAAG,mBAAQ,CAAC"}
+{"version":3,"file":"monitors.js","sourceRoot":"","sources":["../../src/resources/monitors/monitors.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAElD,mEAA0C;AAC1C,4CASoB;AAGpB,uDAAiD;AAEjD;;GAEG;AACH,MAAa,QAAS,SAAQ,sBAAW;IAAzC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAsE1E,CAAC;IApEC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAU,EAAE,IAAyB,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;OAOG;IACH,UAAU,CAAC,EAAU,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;CACF;AAvED,4BAuEC;AAgFD,QAAQ,CAAC,QAAQ,GAAG,mBAAQ,CAAC"}

package/resources/monitors/monitors.mjs

@@ -4,7 +4,7 @@ import * as KeywordsAPI from "./keywords.mjs";
 import { Keywords, } from "./keywords.mjs";
 import { path } from "../../internal/utils/path.mjs";
 /**
- * Real-time X account monitoring
+ * X account monitoring with 1-second checks
  */
 export class Monitors extends APIResource {
     constructor() {
@@ -12,9 +12,10 @@ export class Monitors extends APIResource {
         this.keywords = new KeywordsAPI.Keywords(this._client);
     }
     /**
-     * Creates an instant monitor. Monitors are unlimited. Active monitors check every
-     * 1 second. Events and webhook deliveries are included. Creation requires an
-     * available usage balance.
+     * Creates an account monitor. Monitors are unlimited. Active monitors check every
+     * 1 second and cost 21 credits per hour. Events and webhook deliveries are
+     * included. Creation requires available credits for the first hourly charge and
+     * username lookup.
      *
      * @example
      * ```ts

package/resources/monitors/monitors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"monitors.mjs","sourceRoot":"","sources":["../../src/resources/monitors/monitors.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAElD,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EAQL,QAAQ,GACT,uBAAmB;AAGpB,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IAAzC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAqE1E,CAAC;IAnEC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAU,EAAE,IAAyB,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,aAAa,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;OAOG;IACH,UAAU,CAAC,EAAU,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,aAAa,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;CACF;AAgFD,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"monitors.mjs","sourceRoot":"","sources":["../../src/resources/monitors/monitors.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAElD,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EAQL,QAAQ,GACT,uBAAmB;AAGpB,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IAAzC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAsE1E,CAAC;IApEC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAU,EAAE,IAAyB,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,aAAa,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;OAOG;IACH,UAAU,CAAC,EAAU,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,aAAa,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;CACF;AAgFD,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC"}

package/src/client.ts

@@ -918,7 +918,7 @@ export class XTwitterScraper {
    */
   radar: API.Radar = new API.Radar(this);
   /**
-   * Real-time X account monitoring
+   * X account monitoring with 1-second checks
    */
   monitors: API.Monitors = new API.Monitors(this);
   /**

package/src/resources/account.ts

@@ -89,12 +89,12 @@ export namespace AccountRetrieveResponse {
     activeHourlyBurn: string;
 
     /**
-     * Estimated daily usage for 1 active instant monitor.
+     * Rounded daily estimate for 1 active monitor.
      */
     creditsPerActiveMonitorDay: string;
 
     /**
-     * Hourly usage charged for 1 active instant monitor.
+     * Hourly credits charged for 1 active monitor.
      */
     creditsPerActiveMonitorHour: string;
 

package/src/resources/compose.ts

@@ -9,14 +9,17 @@ import { RequestOptions } from '../internal/request-options';
  */
 export class Compose extends APIResource {
   /**
-   * Compose, refine, or score a tweet
+   * Run one step of Xquik's three-step writing workflow. Compose returns questions
+   * and editorial rules. Refine returns goal-specific guidance. Score applies
+   * deterministic text checks. It does not predict reach or expose X ranking
+   * weights.
    *
    * @example
    * ```ts
    * const compose = await client.compose.create({
    *   step: 'compose',
+   *   topic: 'PostgreSQL query planning',
    *   goal: 'engagement',
-   *   topic: 'AI trends in 2025',
    * });
    * ```
    */
@@ -25,85 +28,249 @@ export class Compose extends APIResource {
   }
 }
 
-export interface ComposeCreateResponse {
-  /**
-   * AI feedback on the draft
-   */
-  feedback?: string;
+export type ComposeCreateResponse =
+  | ComposeCreateResponse.ComposePrepareResult
+  | ComposeCreateResponse.ComposeRefineResult
+  | ComposeCreateResponse.ComposeScoreResult;
 
-  /**
-   * Engagement score (0-100)
-   */
-  score?: number;
+export namespace ComposeCreateResponse {
+  export interface ComposePrepareResult {
+    /**
+     * Xquik editorial heuristics, ordered for the goal.
+     */
+    contentRules: Array<ComposePrepareResult.ContentRule>;
 
-  /**
-   * Improvement suggestions
-   */
-  suggestions?: Array<string>;
+    /**
+     * Published engagement signal names. Production multipliers are not published.
+     */
+    engagementMultipliers: Array<ComposePrepareResult.EngagementMultiplier>;
 
-  /**
-   * Generated or refined tweet text
-   */
-  text?: string;
+    /**
+     * Publication limit for timing and decay claims.
+     */
+    engagementVelocity: string;
+
+    followUpQuestions: Array<string>;
+
+    /**
+     * X post intent seeded with the topic.
+     */
+    intentUrl: string;
+
+    nextStep: string;
+
+    /**
+     * Published signal names with unpublished weights as null.
+     */
+    scorerWeights: Array<ComposePrepareResult.ScorerWeight>;
+
+    /**
+     * Signal source and evidence limits.
+     */
+    source: string;
+
+    /**
+     * Negative engagement predictions in the public model.
+     */
+    topPenalties: Array<string>;
+
+    /**
+     * Style analyses saved to the account.
+     */
+    savedStyles?: Array<ComposePrepareResult.SavedStyle>;
+
+    /**
+     * Next action when no cached style is available.
+     */
+    styleNote?: string;
+
+    /**
+     * Cached examples for the requested style username.
+     */
+    styleTweets?: Array<string>;
+  }
+
+  export namespace ComposePrepareResult {
+    export interface ContentRule {
+      rule: string;
+    }
+
+    export interface EngagementMultiplier {
+      /**
+       * Human-readable published signal name.
+       */
+      action: string;
+
+      multiplier: 'Production weight not published by X';
+    }
+
+    export interface ScorerWeight {
+      /**
+       * Signal direction and publication limit.
+       */
+      context: string;
+
+      /**
+       * Signal name from X's public ranking repository.
+       */
+      signal: string;
+
+      /**
+       * X does not publish the production weight.
+       */
+      weight: null;
+    }
+
+    export interface SavedStyle {
+      tweetCount: number;
+
+      username: string;
+    }
+  }
+
+  export interface ComposeRefineResult {
+    /**
+     * Goal, tone, media, and editorial guidance.
+     */
+    compositionGuidance: Array<string>;
+
+    examplePatterns: Array<ComposeRefineResult.ExamplePattern>;
+
+    /**
+     * X post intent seeded with the topic.
+     */
+    intentUrl: string;
+
+    nextStep: string;
+  }
+
+  export namespace ComposeRefineResult {
+    export interface ExamplePattern {
+      description: string;
+
+      pattern: string;
+    }
+  }
+
+  export interface ComposeScoreResult {
+    /**
+     * Deterministic editorial checks. Not a reach prediction.
+     */
+    checklist: Array<ComposeScoreResult.Checklist>;
+
+    nextStep: string;
+
+    passed: boolean;
+
+    passedCount: number;
+
+    topSuggestion: string;
 
-  [k: string]: unknown;
+    totalChecks: 9;
+
+    /**
+     * Present only when every check passes.
+     */
+    intentUrl?: string;
+  }
+
+  export namespace ComposeScoreResult {
+    export interface Checklist {
+      factor: string;
+
+      passed: boolean;
+
+      /**
+       * Present only when the check fails.
+       */
+      suggestion?: string;
+    }
+  }
 }
 
-export interface ComposeCreateParams {
-  /**
-   * Workflow step
-   */
-  step: 'compose' | 'refine' | 'score';
+export type ComposeCreateParams =
+  | ComposeCreateParams.ComposePrepareRequest
+  | ComposeCreateParams.ComposeRefineRequest
+  | ComposeCreateParams.ComposeScoreRequest;
 
-  /**
-   * Extra context or URLs (refine)
-   */
-  additionalContext?: string;
+export declare namespace ComposeCreateParams {
+  export interface ComposePrepareRequest {
+    step: 'compose';
 
-  /**
-   * Desired call to action (refine)
-   */
-  callToAction?: string;
+    /**
+     * Subject for the post.
+     */
+    topic: string;
 
-  /**
-   * Tweet draft text to evaluate (score)
-   */
-  draft?: string;
+    /**
+     * Editorial goal used to order the rules and questions.
+     */
+    goal?: 'engagement' | 'followers' | 'authority' | 'conversation';
 
-  /**
-   * Optimization goal
-   */
-  goal?: 'engagement' | 'followers' | 'authority' | 'conversation';
+    /**
+     * Username from a style analysis saved to this account.
+     */
+    styleUsername?: string;
 
-  /**
-   * Whether a link is attached (score)
-   */
-  hasLink?: boolean;
+    [k: string]: unknown;
+  }
 
-  /**
-   * Whether media is attached (score)
-   */
-  hasMedia?: boolean;
+  export interface ComposeRefineRequest {
+    /**
+     * Editorial goal for the guidance.
+     */
+    goal: 'engagement' | 'followers' | 'authority' | 'conversation';
 
-  /**
-   * Media type (refine)
-   */
-  mediaType?: 'photo' | 'video' | 'none';
+    step: 'refine';
 
-  /**
-   * Cached style username for voice matching (compose)
-   */
-  styleUsername?: string;
+    /**
+     * Requested writing tone.
+     */
+    tone: string;
 
-  /**
-   * Desired tone (refine)
-   */
-  tone?: string;
+    /**
+     * Subject for the post.
+     */
+    topic: string;
 
-  /**
-   * Tweet topic (compose, refine)
-   */
-  topic?: string;
+    /**
+     * Audience, constraints, sources, or other writing context.
+     */
+    additionalContext?: string;
+
+    /**
+     * Specific action the draft should request.
+     */
+    callToAction?: string;
+
+    /**
+     * Planned media type.
+     */
+    mediaType?: 'photo' | 'video' | 'none';
+
+    [k: string]: unknown;
+  }
+
+  export interface ComposeScoreRequest {
+    /**
+     * Full post text for deterministic editorial checks.
+     */
+    draft: string;
+
+    step: 'score';
+
+    /**
+     * True when a separate link card is attached.
+     */
+    hasLink?: boolean;
+
+    /**
+     * @deprecated Ignored. Remove this field. Use hasLink for a separate link card.
+     */
+    hasMedia?: boolean;
+
+    [k: string]: unknown;
+  }
 }
 
 export declare namespace Compose {

package/src/resources/monitors/keywords.ts

@@ -7,13 +7,13 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 /**
- * Real-time X account monitoring
+ * X account monitoring with 1-second checks
  */
 export class Keywords extends APIResource {
   /**
-   * Creates an instant keyword monitor. Keyword monitors are unlimited. Active
-   * monitors check every 1 second. Events and webhook deliveries are included.
-   * Creation requires an available usage balance.
+   * Creates a keyword monitor. Keyword monitors are unlimited. Active monitors check
+   * every 1 second and cost 21 credits per hour. Events and webhook deliveries are
+   * included. Creation requires available credits for the first hourly charge.
    *
    * @example
    * ```ts