glitch-javascript-sdk 3.2.24 → 3.2.26

package/src/api/PrDirectory.ts

@@ -40,6 +40,16 @@ export type PrContactVerificationStatus =
  */
 export type PrLinkStatus = "unverified" | "ok" | "redirected" | "broken" | "blocked" | "failed" | "stale";
 
+/**
+ * Refresh state for discovered RSS/Atom/JSON feeds.
+ */
+export type PrFeedStatus = "unverified" | "ok" | "empty" | "blocked" | "failed" | "stale" | "needs_review";
+
+/**
+ * Feed format detected during PR content ingestion.
+ */
+export type PrFeedType = "rss" | "atom" | "json" | "unknown";
+
 /**
  * Filters accepted by `/pr/publications` and `/pr/report`.
  *
@@ -85,6 +95,41 @@ export interface PrPeopleSearchParams {
   per_page?: number;
 }
 
+/**
+ * Filters accepted by `/pr/feeds`.
+ */
+export interface PrFeedSearchParams {
+  q?: string;
+  publication_id?: string;
+  feed_type?: PrFeedType;
+  status?: PrFeedStatus;
+  source?: string;
+  has_stories?: boolean;
+  sort?: "title" | "-title" | "feed_type" | "-feed_type" | "status" | "-status" | "last_fetched_at" | "-last_fetched_at" | "next_fetch_at" | "-next_fetch_at" | "updated_at" | "-updated_at" | string;
+  page?: number;
+  per_page?: number;
+  include_raw?: boolean;
+}
+
+/**
+ * Filters accepted by `/pr/stories`.
+ */
+export interface PrStorySearchParams {
+  q?: string;
+  publication_id?: string;
+  pr_feed_id?: string;
+  pr_person_id?: string;
+  story_type?: string;
+  language?: string;
+  ingestion_status?: string;
+  has_author?: boolean;
+  published_after?: string;
+  published_before?: string;
+  sort?: "published_at" | "-published_at" | "updated_at" | "-updated_at" | "title" | "-title" | string;
+  page?: number;
+  per_page?: number;
+}
+
 /**
  * Filters accepted by `/pr/tags`.
  */
@@ -106,6 +151,14 @@ export interface PrTitleMatchParams extends PrPublicationSearchParams {
   limit?: number;
 }
 
+/**
+ * Query parameters accepted by `/titles/{title_id}/pr/research`.
+ */
+export interface PrTitleResearchParams extends PrStorySearchParams {
+  limit?: number;
+  story_sort?: string;
+}
+
 /**
  * Request body accepted by `/admin/pr/verification/queue`.
  */
@@ -115,6 +168,36 @@ export interface PrQueueVerificationRequest {
   link_ids?: string[];
 }
 
+/**
+ * Review-only PR draft request for `/titles/{title_id}/pr/drafts`.
+ */
+export interface PrTitleDraftRequest {
+  publication_id?: string;
+  pr_person_id?: string;
+  q?: string;
+  prompt?: string;
+  press_kit_url?: string;
+  trailer_url?: string;
+  demo_or_review_key?: string;
+  embargo_or_timing?: string;
+  sender?: {
+    name?: string;
+  };
+  use_ai?: boolean;
+}
+
+/**
+ * Admin request body for `/admin/pr/feeds/refresh`.
+ */
+export interface PrFeedRefreshRequest {
+  discover?: boolean;
+  due?: boolean;
+  queue?: boolean;
+  limit?: number;
+  feed_ids?: string[];
+  publication_ids?: string[];
+}
+
 /**
  * A normalized metadata tag used to filter and match PR outlets, people, and
  * roles.
@@ -166,6 +249,93 @@ export interface PrLink {
   updated_at?: string | null;
 }
 
+/**
+ * RSS/Atom/JSON feed discovered for a publication and used for story research.
+ */
+export interface PrFeed {
+  id: string;
+  publication_id: string;
+  pr_link_id?: string | null;
+  feed_url: string;
+  canonical_url?: string | null;
+  feed_type: PrFeedType;
+  title?: string | null;
+  description?: string | null;
+  language?: string | null;
+  status: PrFeedStatus;
+  http_status?: number | null;
+  content_type?: string | null;
+  etag?: string | null;
+  raw_feed_hash?: string | null;
+  raw_feed_content?: string | null;
+  raw_feed_size?: number;
+  last_modified_at?: string | null;
+  last_fetched_at?: string | null;
+  next_fetch_at?: string | null;
+  item_count_last_fetch: number;
+  source?: string | null;
+  last_error?: string | null;
+  publication?: PrPublication | null;
+  stories_count?: number;
+  stories?: PrStory[];
+  metadata?: Record<string, any>;
+  created_at?: string | null;
+  updated_at?: string | null;
+}
+
+/**
+ * A story, article, guide, review, or episode imported from a PR feed.
+ */
+export interface PrStory {
+  id: string;
+  publication_id: string;
+  pr_feed_id?: string | null;
+  canonical_url?: string | null;
+  guid?: string | null;
+  title: string;
+  dek?: string | null;
+  summary?: string | null;
+  content_excerpt?: string | null;
+  content_hash?: string | null;
+  author_name_raw?: string | null;
+  author_email_raw?: string | null;
+  author_url_raw?: string | null;
+  published_at?: string | null;
+  updated_at_feed?: string | null;
+  story_type?: string | null;
+  language?: string | null;
+  categories?: string[];
+  tags?: string[];
+  media_url?: string | null;
+  analysis?: Record<string, any>;
+  ingestion_status?: string | null;
+  publication?: PrPublication | null;
+  feed?: PrFeed | null;
+  authors?: PrStoryAuthor[];
+  created_at?: string | null;
+  updated_at?: string | null;
+}
+
+/**
+ * Raw byline evidence and optional match to a known PR contact.
+ */
+export interface PrStoryAuthor {
+  id: string;
+  pr_story_id: string;
+  publication_id?: string | null;
+  pr_person_id?: string | null;
+  author_name?: string | null;
+  author_email?: string | null;
+  author_url?: string | null;
+  confidence?: number | null;
+  match_source?: string | null;
+  evidence?: Record<string, any>;
+  story?: PrStory | null;
+  person?: PrPerson | null;
+  created_at?: string | null;
+  updated_at?: string | null;
+}
+
 /**
  * A normalized way to reach an outlet, person, or publication role.
  */
@@ -245,9 +415,13 @@ export interface PrPublication {
   people_count?: number;
   contact_points_count?: number;
   links_count?: number;
+  feeds_count?: number;
+  stories_count?: number;
   people?: PublicationPerson[];
   contact_points?: PrContactPoint[];
   links?: PrLink[];
+  feeds?: PrFeed[];
+  stories?: PrStory[];
   tags?: PrTag[];
   metadata?: Record<string, any>;
   created_at?: string | null;
@@ -275,9 +449,11 @@ export interface PrPerson {
   roles_count?: number;
   contact_points_count?: number;
   links_count?: number;
+  stories_count?: number;
   roles?: PublicationPerson[];
   contact_points?: PrContactPoint[];
   links?: PrLink[];
+  stories?: PrStoryAuthor[];
   tags?: PrTag[];
   metadata?: Record<string, any>;
   created_at?: string | null;
@@ -319,6 +495,16 @@ export interface PrDirectoryReport {
     total: number;
     by_namespace: Record<string, number>;
   };
+  feeds: {
+    total: number;
+    by_status: Record<string, number>;
+    due_for_fetch: number;
+  };
+  stories: {
+    total: number;
+    with_author: number;
+    by_type: Record<string, number>;
+  };
 }
 
 /**
@@ -335,6 +521,70 @@ export interface PrTitleMatch {
   evidence_links: PrLink[];
 }
 
+/**
+ * Title-scoped PR research workspace response.
+ */
+export interface PrTitleResearchResponse {
+  generated_at: string;
+  title: {
+    id: string;
+    name: string;
+    slug?: string | null;
+    short_description?: string | null;
+    description?: string | null;
+    genres?: string[];
+    platforms?: string[];
+    website_url?: string | null;
+    steam_url?: string | null;
+    itch_url?: string | null;
+    demo_url?: string | null;
+    video_url?: string | null;
+  };
+  readiness: {
+    score: number;
+    strengths: string[];
+    gaps: string[];
+  };
+  publication_matches: PrTitleMatch[];
+  stories: PrStory[];
+  story_summary: {
+    count: number;
+    with_known_author: number;
+    publication_count: number;
+  };
+  suggested_next_steps: string[];
+}
+
+/**
+ * Structured draft fields returned alongside the formatted HTML email body.
+ */
+export interface PrOutreachDraft {
+  subject?: string | null;
+  opener?: string | null;
+  body?: string | null;
+  body_html?: string | null;
+  key_points?: string[];
+  personalization_notes?: string[];
+  review_notes?: string[];
+  missing_context_warnings?: string[];
+  [key: string]: any;
+}
+
+/**
+ * Review-only PR draft response. The API never sends email from this endpoint.
+ */
+export interface PrTitleDraftResponse {
+  draft_status: "draft_only_not_sent" | "no_verified_email_found" | "no_publication_found" | string;
+  emails_sent: boolean;
+  publication?: PrPublication | null;
+  person?: PrPerson | null;
+  target: Record<string, any>;
+  recent_stories: PrStory[];
+  draft: PrOutreachDraft;
+  body_html: string;
+  review_notes: string[];
+}
+
 /**
  * Response body returned after queueing PR verification jobs.
  */
@@ -342,13 +592,22 @@ export interface PrQueueVerificationResponse {
   queued: number;
 }
 
+/**
+ * Response body returned after discovering, queueing, or fetching PR feeds.
+ */
+export interface PrFeedRefreshResponse {
+  discovered: number;
+  queued: number;
+  fetched: number;
+}
+
 /**
  * SDK wrapper for the PR Directory API.
  *
  * The PR directory is read-friendly by default: public endpoints expose
- * searchable publications, people, tags, and reporting metrics. Authenticated
- * title admins can request title-specific PR matches, and site admins can queue
- * monthly-style verification jobs.
+ * searchable publications, people, feeds, stories, tags, and reporting metrics.
+ * Authenticated title admins can request title-specific research and review-only
+ * outreach drafts, and site admins can queue verification or feed refresh jobs.
  */
 class PrDirectory {
   /**
@@ -400,6 +659,35 @@ class PrDirectory {
     return Requests.processRoute(PrDirectoryRoutes.routes.viewPerson, {}, { person_id }, params);
   }
 
+  /**
+   * Search discovered RSS/Atom/JSON feeds across known publications.
+   */
+  public static listFeeds<T = PrFeed[]>(params?: PrFeedSearchParams): AxiosPromise<Response<T>> {
+    return Requests.processRoute(PrDirectoryRoutes.routes.listFeeds, {}, {}, params);
+  }
+
+  /**
+   * Retrieve one feed with freshness metadata and recent imported stories.
+   * Pass `include_raw: true` to request the stored XML/RSS payload.
+   */
+  public static viewFeed<T = PrFeed>(feed_id: string, params?: PrFeedSearchParams): AxiosPromise<Response<T>> {
+    return Requests.processRoute(PrDirectoryRoutes.routes.viewFeed, {}, { feed_id }, params);
+  }
+
+  /**
+   * Search imported stories, reviews, guides, and episodes by outlet or byline.
+   */
+  public static listStories<T = PrStory[]>(params?: PrStorySearchParams): AxiosPromise<Response<T>> {
+    return Requests.processRoute(PrDirectoryRoutes.routes.listStories, {}, {}, params);
+  }
+
+  /**
+   * Retrieve one imported story with feed, publication, and byline evidence.
+   */
+  public static viewStory<T = PrStory>(story_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(PrDirectoryRoutes.routes.viewStory, {}, { story_id }, params);
+  }
+
   /**
    * List the normalized tag vocabulary used for PR search, filters, matching,
    * and reporting.
@@ -424,6 +712,22 @@ class PrDirectory {
     return Requests.processRoute(PrDirectoryRoutes.routes.titleMatches, {}, { title_id }, params);
   }
 
+  /**
+   * Get a title-scoped PR research workspace with outlet matches, recent story
+   * context, media kit readiness, and next steps.
+   */
+  public static titleResearch<T = PrTitleResearchResponse>(title_id: string, params?: PrTitleResearchParams): AxiosPromise<Response<T>> {
+    return Requests.processRoute(PrDirectoryRoutes.routes.titleResearch, {}, { title_id }, params);
+  }
+
+  /**
+   * Create a formatted, review-only PR email draft for a selected title target.
+   * The backend returns HTML with paragraphs, bullets, and links but sends no email.
+   */
+  public static titleDraft<T = PrTitleDraftResponse>(title_id: string, data?: PrTitleDraftRequest, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(PrDirectoryRoutes.routes.titleDraft, data || {}, { title_id }, params);
+  }
+
   /**
    * Queue PR verification jobs. Requires a site-admin auth token.
    *
@@ -435,6 +739,14 @@ class PrDirectory {
   public static queueVerification<T = PrQueueVerificationResponse>(data?: PrQueueVerificationRequest, params?: Record<string, any>): AxiosPromise<Response<T>> {
     return Requests.processRoute(PrDirectoryRoutes.routes.queueVerification, data || {}, {}, params);
   }
+
+  /**
+   * Discover, queue, or synchronously refresh PR feeds. Requires a site-admin
+   * auth token.
+   */
+  public static refreshFeeds<T = PrFeedRefreshResponse>(data?: PrFeedRefreshRequest, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(PrDirectoryRoutes.routes.refreshFeeds, data || {}, {}, params);
+  }
 }
 
 export default PrDirectory;

package/src/routes/GameShowsRoute.ts

@@ -31,6 +31,7 @@ class GameShowsRoute {
         analyticsReport: { url: '/gameshows/{show_id}/analytics/report', method: HTTP_METHODS.GET },
         joinWishlist: { url: '/gameshows/{show_id}/wishlist', method: HTTP_METHODS.POST },
         listWishlist: { url: '/gameshows/{show_id}/wishlist', method: HTTP_METHODS.GET },
+        listForTitle: { url: '/titles/{title_id}/gameshows', method: HTTP_METHODS.GET },
     };
 
   }

package/src/routes/PrDirectoryRoutes.ts

@@ -5,7 +5,7 @@ import HTTP_METHODS from "../constants/HttpMethods";
  * Route declarations for the PR Directory API.
  *
  * These mirror the Laravel routes under `/api/pr/*` and the title-scoped
- * matcher route under `/api/titles/{title_id}/pr/matches`. Keeping the URL
+ * matcher/research routes under `/api/titles/{title_id}/pr/*`. Keeping the URL
  * templates in one place lets the SDK methods stay small and consistent with
  * the rest of the package's route-wrapper pattern.
  */
@@ -15,10 +15,17 @@ class PrDirectoryRoutes {
     viewPublication: { url: "/pr/publications/{publication_id}", method: HTTP_METHODS.GET },
     listPeople: { url: "/pr/people", method: HTTP_METHODS.GET },
     viewPerson: { url: "/pr/people/{person_id}", method: HTTP_METHODS.GET },
+    listFeeds: { url: "/pr/feeds", method: HTTP_METHODS.GET },
+    viewFeed: { url: "/pr/feeds/{feed_id}", method: HTTP_METHODS.GET },
+    listStories: { url: "/pr/stories", method: HTTP_METHODS.GET },
+    viewStory: { url: "/pr/stories/{story_id}", method: HTTP_METHODS.GET },
     listTags: { url: "/pr/tags", method: HTTP_METHODS.GET },
     report: { url: "/pr/report", method: HTTP_METHODS.GET },
     titleMatches: { url: "/titles/{title_id}/pr/matches", method: HTTP_METHODS.GET },
+    titleResearch: { url: "/titles/{title_id}/pr/research", method: HTTP_METHODS.GET },
+    titleDraft: { url: "/titles/{title_id}/pr/drafts", method: HTTP_METHODS.POST },
     queueVerification: { url: "/admin/pr/verification/queue", method: HTTP_METHODS.POST },
+    refreshFeeds: { url: "/admin/pr/feeds/refresh", method: HTTP_METHODS.POST },
   };
 }