glitch-javascript-sdk 3.2.25 → 3.2.26

package/dist/esm/api/PrDirectory.d.ts

@@ -24,6 +24,14 @@ export type PrContactVerificationStatus = "unverified" | "verified" | "stale" |
  * Link refresh status for evidence URLs.
  */
 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`.
  *
@@ -67,6 +75,39 @@ export interface PrPeopleSearchParams {
     page?: number;
     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`.
  */
@@ -86,6 +127,13 @@ export interface PrTitleMatchParams extends PrPublicationSearchParams {
     audiences?: string[];
     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`.
  */
@@ -94,6 +142,34 @@ export interface PrQueueVerificationRequest {
     limit?: number;
     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.
@@ -143,6 +219,90 @@ export interface PrLink {
     created_at?: string | null;
     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.
  */
@@ -220,9 +380,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;
@@ -249,9 +413,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;
@@ -292,6 +458,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>;
+    };
 }
 /**
  * A ranked title-to-outlet match with evidence, contact route, and plain-English
@@ -306,19 +482,88 @@ export interface PrTitleMatch {
     risks: string[];
     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.
  */
 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.
  */
 declare class PrDirectory {
     /**
@@ -358,6 +603,23 @@ declare class PrDirectory {
      * contact points, and metadata tags.
      */
     static viewPerson<T = PrPerson>(person_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Search discovered RSS/Atom/JSON feeds across known publications.
+     */
+    static listFeeds<T = PrFeed[]>(params?: PrFeedSearchParams): AxiosPromise<Response<T>>;
+    /**
+     * Retrieve one feed with freshness metadata and recent imported stories.
+     * Pass `include_raw: true` to request the stored XML/RSS payload.
+     */
+    static viewFeed<T = PrFeed>(feed_id: string, params?: PrFeedSearchParams): AxiosPromise<Response<T>>;
+    /**
+     * Search imported stories, reviews, guides, and episodes by outlet or byline.
+     */
+    static listStories<T = PrStory[]>(params?: PrStorySearchParams): AxiosPromise<Response<T>>;
+    /**
+     * Retrieve one imported story with feed, publication, and byline evidence.
+     */
+    static viewStory<T = PrStory>(story_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
      * List the normalized tag vocabulary used for PR search, filters, matching,
      * and reporting.
@@ -373,6 +635,16 @@ declare class PrDirectory {
      * user who can administer the requested title.
      */
     static titleMatches<T = PrTitleMatch[]>(title_id: string, params?: PrTitleMatchParams): AxiosPromise<Response<T>>;
+    /**
+     * Get a title-scoped PR research workspace with outlet matches, recent story
+     * context, media kit readiness, and next steps.
+     */
+    static titleResearch<T = PrTitleResearchResponse>(title_id: string, params?: PrTitleResearchParams): AxiosPromise<Response<T>>;
+    /**
+     * 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.
+     */
+    static titleDraft<T = PrTitleDraftResponse>(title_id: string, data?: PrTitleDraftRequest, params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
      * Queue PR verification jobs. Requires a site-admin auth token.
      *
@@ -382,5 +654,10 @@ declare class PrDirectory {
      * ```
      */
     static queueVerification<T = PrQueueVerificationResponse>(data?: PrQueueVerificationRequest, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Discover, queue, or synchronously refresh PR feeds. Requires a site-admin
+     * auth token.
+     */
+    static refreshFeeds<T = PrFeedRefreshResponse>(data?: PrFeedRefreshRequest, params?: Record<string, any>): AxiosPromise<Response<T>>;
 }
 export default PrDirectory;

package/dist/esm/index.js

@@ -19846,7 +19846,7 @@ var Mcp = /** @class */ (function () {
  * 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.
  */
@@ -19858,10 +19858,17 @@ var PrDirectoryRoutes = /** @class */ (function () {
         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 },
     };
     return PrDirectoryRoutes;
 }());
@@ -19870,9 +19877,9 @@ var PrDirectoryRoutes = /** @class */ (function () {
  * 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.
  */
 var PrDirectory = /** @class */ (function () {
     function PrDirectory() {
@@ -19922,6 +19929,31 @@ var PrDirectory = /** @class */ (function () {
     PrDirectory.viewPerson = function (person_id, params) {
         return Requests.processRoute(PrDirectoryRoutes.routes.viewPerson, {}, { person_id: person_id }, params);
     };
+    /**
+     * Search discovered RSS/Atom/JSON feeds across known publications.
+     */
+    PrDirectory.listFeeds = function (params) {
+        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.
+     */
+    PrDirectory.viewFeed = function (feed_id, params) {
+        return Requests.processRoute(PrDirectoryRoutes.routes.viewFeed, {}, { feed_id: feed_id }, params);
+    };
+    /**
+     * Search imported stories, reviews, guides, and episodes by outlet or byline.
+     */
+    PrDirectory.listStories = function (params) {
+        return Requests.processRoute(PrDirectoryRoutes.routes.listStories, {}, {}, params);
+    };
+    /**
+     * Retrieve one imported story with feed, publication, and byline evidence.
+     */
+    PrDirectory.viewStory = function (story_id, params) {
+        return Requests.processRoute(PrDirectoryRoutes.routes.viewStory, {}, { story_id: story_id }, params);
+    };
     /**
      * List the normalized tag vocabulary used for PR search, filters, matching,
      * and reporting.
@@ -19943,6 +19975,20 @@ var PrDirectory = /** @class */ (function () {
     PrDirectory.titleMatches = function (title_id, params) {
         return Requests.processRoute(PrDirectoryRoutes.routes.titleMatches, {}, { title_id: title_id }, params);
     };
+    /**
+     * Get a title-scoped PR research workspace with outlet matches, recent story
+     * context, media kit readiness, and next steps.
+     */
+    PrDirectory.titleResearch = function (title_id, params) {
+        return Requests.processRoute(PrDirectoryRoutes.routes.titleResearch, {}, { title_id: 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.
+     */
+    PrDirectory.titleDraft = function (title_id, data, params) {
+        return Requests.processRoute(PrDirectoryRoutes.routes.titleDraft, data || {}, { title_id: title_id }, params);
+    };
     /**
      * Queue PR verification jobs. Requires a site-admin auth token.
      *
@@ -19954,6 +20000,13 @@ var PrDirectory = /** @class */ (function () {
     PrDirectory.queueVerification = function (data, params) {
         return Requests.processRoute(PrDirectoryRoutes.routes.queueVerification, data || {}, {}, params);
     };
+    /**
+     * Discover, queue, or synchronously refresh PR feeds. Requires a site-admin
+     * auth token.
+     */
+    PrDirectory.refreshFeeds = function (data, params) {
+        return Requests.processRoute(PrDirectoryRoutes.routes.refreshFeeds, data || {}, {}, params);
+    };
     return PrDirectory;
 }());