gdelt-ts-client 1.0.0

package/dist/interfaces/api-responses.d.ts

@@ -0,0 +1,258 @@
+/**
+ * Interfaces for GDELT API responses
+ */
+/**
+ * Base interface for all GDELT API responses
+ */
+export interface IGdeltApiResponse {
+    /**
+     * Status of the API request
+     */
+    status: string;
+}
+/**
+ * Interface for an article in the GDELT API response
+ */
+export interface IArticle {
+    /**
+     * The URL of the article
+     */
+    url: string;
+    /**
+     * The title of the article
+     */
+    title: string;
+    /**
+     * The date the article was published
+     * Format: YYYYMMDDHHMMSS
+     */
+    seendate: string;
+    /**
+     * The domain of the article
+     */
+    domain: string;
+    /**
+     * The country where the article was published
+     */
+    sourcecountry: string;
+    /**
+     * The language the article was originally published in
+     */
+    sourcelanguage: string;
+    /**
+     * The URL of the social sharing image for the article
+     */
+    socialimage?: string;
+    /**
+     * The tone score of the article
+     * Range: -100 (extremely negative) to +100 (extremely positive)
+     */
+    tone?: number;
+}
+/**
+ * Interface for the article list response
+ */
+export interface IArticleListResponse extends IGdeltApiResponse {
+    /**
+     * The list of articles that matched the query
+     */
+    articles: IArticle[];
+    /**
+     * The total number of articles that matched the query
+     */
+    count: number;
+}
+/**
+ * Interface for an image in the GDELT API response
+ */
+export interface IImage {
+    /**
+     * The URL of the image
+     */
+    url: string;
+    /**
+     * The URL of the article containing the image
+     */
+    articleurl: string;
+    /**
+     * The date the image was seen
+     * Format: YYYYMMDDHHMMSS
+     */
+    seendate: string;
+    /**
+     * The number of times the image has been seen on the web
+     * Only available in ImageCollageInfo mode
+     */
+    webcount?: number;
+    /**
+     * The list of URLs where the image has been seen before
+     * Only available in ImageCollageInfo mode
+     */
+    webexamples?: string[];
+    /**
+     * The date the image was captured according to its metadata
+     * Format: YYYYMMDDHHMMSS
+     * Only available in ImageCollageInfo mode
+     */
+    capturedate?: string;
+    /**
+     * Whether the image is older than 72 hours
+     * Only available in ImageCollageInfo mode
+     */
+    oldimage?: boolean;
+    /**
+     * The tags assigned to the image by Google's algorithms
+     * Only available when using imagetag in the query
+     */
+    tags?: string[];
+    /**
+     * The web tags derived from captions across the web
+     * Only available when using imagewebtag in the query
+     */
+    webtags?: string[];
+    /**
+     * The average tone of human facial emotions in the image
+     * Only available when using imagefacetone in the query
+     */
+    facetone?: number;
+    /**
+     * The number of human faces in the image
+     * Only available when using imagenumfaces in the query
+     */
+    numfaces?: number;
+}
+/**
+ * Interface for the image collage response
+ */
+export interface IImageCollageResponse extends IGdeltApiResponse {
+    /**
+     * The list of images that matched the query
+     */
+    images: IImage[];
+    /**
+     * The total number of images that matched the query
+     */
+    count: number;
+}
+/**
+ * Interface for a timeline data point
+ */
+export interface ITimelineDataPoint {
+    /**
+     * The date of the data point
+     * Format varies based on the timespan
+     */
+    date: string;
+    /**
+     * The value of the data point
+     * For TimelineVol: percentage of all global coverage
+     * For TimelineVolRaw: raw count of articles
+     * For TimelineTone: average tone
+     */
+    value: number;
+    /**
+     * The total number of all articles monitored during that time interval
+     * Only available in TimelineVolRaw mode
+     */
+    norm?: number;
+    /**
+     * The top 10 most relevant articles for this time step
+     * Only available in TimelineVolInfo mode
+     */
+    articles?: IArticle[];
+}
+/**
+ * Interface for the timeline response
+ */
+export interface ITimelineResponse extends IGdeltApiResponse {
+    /**
+     * The timeline data points
+     */
+    timeline: ITimelineDataPoint[];
+}
+/**
+ * Interface for a language or country data point in timeline responses
+ */
+export interface ITimelineBreakdownDataPoint {
+    /**
+     * The date of the data point
+     */
+    date: string;
+    /**
+     * The values for each language or country
+     * Key: language code or country code
+     * Value: percentage or count
+     */
+    values: Record<string, number>;
+}
+/**
+ * Interface for the timeline language or country breakdown response
+ */
+export interface ITimelineBreakdownResponse extends IGdeltApiResponse {
+    /**
+     * The timeline data points with language or country breakdown
+     */
+    timeline: ITimelineBreakdownDataPoint[];
+    /**
+     * The list of languages or countries in the response
+     */
+    labels: string[];
+}
+/**
+ * Interface for a tone bin in the tone chart response
+ */
+export interface IToneBin {
+    /**
+     * The tone bin value
+     */
+    bin: number;
+    /**
+     * The number of articles in this tone bin
+     */
+    count: number;
+    /**
+     * The top articles in this tone bin
+     */
+    toparts: {
+        /**
+         * The URL of the article
+         */
+        url: string;
+        /**
+         * The title of the article
+         */
+        title: string;
+    }[];
+}
+/**
+ * Interface for the tone chart response
+ */
+export interface IToneChartResponse extends IGdeltApiResponse {
+    /**
+     * The tone chart data
+     */
+    tonechart: IToneBin[];
+}
+/**
+ * Interface for a word cloud tag
+ */
+export interface IWordCloudTag {
+    /**
+     * The tag text
+     */
+    tag: string;
+    /**
+     * The weight of the tag (frequency)
+     */
+    weight: number;
+}
+/**
+ * Interface for the word cloud response
+ */
+export interface IWordCloudResponse extends IGdeltApiResponse {
+    /**
+     * The word cloud tags
+     */
+    tags: IWordCloudTag[];
+}
+//# sourceMappingURL=api-responses.d.ts.map

package/dist/interfaces/api-responses.d.ts.map

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

package/dist/interfaces/api-responses.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Interfaces for GDELT API responses
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=api-responses.js.map

package/dist/interfaces/api-responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-responses.js","sourceRoot":"","sources":["../../src/interfaces/api-responses.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/types/enhanced-types.d.ts

@@ -0,0 +1,227 @@
+/**
+ * Enhanced types for better developer experience and type safety
+ */
+/**
+ * Mode constants using const assertions for better IntelliSense and extensibility
+ */
+export declare const Mode: {
+    readonly ARTICLE_LIST: "artlist";
+    readonly ARTICLE_GALLERY: "artgallery";
+    readonly IMAGE_COLLAGE: "imagecollage";
+    readonly IMAGE_COLLAGE_INFO: "imagecollageinfo";
+    readonly IMAGE_GALLERY: "imagegallery";
+    readonly IMAGE_COLLAGE_SHARE: "imagecollagesshare";
+    readonly TIMELINE_VOLUME: "timelinevol";
+    readonly TIMELINE_VOLUME_RAW: "timelinevolraw";
+    readonly TIMELINE_VOLUME_INFO: "timelinevolinfo";
+    readonly TIMELINE_TONE: "timelinetone";
+    readonly TIMELINE_LANGUAGE: "timelinelang";
+    readonly TIMELINE_SOURCE_COUNTRY: "timelinesourcecountry";
+    readonly TONE_CHART: "tonechart";
+    readonly WORD_CLOUD_IMAGE_TAGS: "wordcloudimagetags";
+    readonly WORD_CLOUD_IMAGE_WEB_TAGS: "wordcloudimagewebtags";
+};
+export type ModeType = typeof Mode[keyof typeof Mode];
+/**
+ * Format constants using const assertions
+ */
+export declare const Format: {
+    readonly HTML: "html";
+    readonly CSV: "csv";
+    readonly RSS: "rss";
+    readonly RSS_ARCHIVE: "rssarchive";
+    readonly JSON: "json";
+    readonly JSONP: "jsonp";
+    readonly JSON_FEED: "jsonfeed";
+};
+export type FormatType = typeof Format[keyof typeof Format];
+/**
+ * Timespan unit constants using const assertions
+ */
+export declare const TimespanUnit: {
+    readonly MINUTES: "min";
+    readonly HOURS: "h";
+    readonly DAYS: "d";
+    readonly WEEKS: "w";
+    readonly MONTHS: "m";
+};
+export type TimespanUnitType = typeof TimespanUnit[keyof typeof TimespanUnit];
+/**
+ * Sort option constants using const assertions
+ */
+export declare const SortOrder: {
+    readonly DATE_DESC: "datedesc";
+    readonly DATE_ASC: "dateasc";
+    readonly TONE_DESC: "tonedesc";
+    readonly TONE_ASC: "toneasc";
+    readonly HYBRID_RELEVANCE: "hybridrel";
+};
+export type SortOrderType = typeof SortOrder[keyof typeof SortOrder];
+/**
+ * Template literal types for timespan validation
+ */
+export type TimespanString = `${number}min` | `${number}h` | `${number}d` | `${number}w` | `${number}m`;
+/**
+ * Template literal types for datetime validation (YYYYMMDDHHMMSS)
+ */
+export type DateTimeString = `${number}${number}${number}${number}${number}${number}${number}${number}${number}${number}${number}${number}${number}${number}`;
+/**
+ * Template literal types for tone queries
+ */
+export type ToneQuery = `tone>${number}` | `tone<${number}` | `tone=${number}` | `toneabs>${number}` | `toneabs<${number}` | `toneabs=${number}`;
+/**
+ * Template literal types for domain queries
+ */
+export type DomainQuery = `domain:${string}` | `domainis:${string}`;
+/**
+ * Template literal types for source queries
+ */
+export type SourceQuery = `sourcecountry:${string}` | `sourcelang:${string}`;
+/**
+ * Template literal types for image queries
+ */
+export type ImageQuery = `imagetag:"${string}"` | `imagewebtag:"${string}"` | `imageocrmeta:"${string}"` | `imagefacetone>${number}` | `imagefacetone<${number}` | `imagenumfaces>${number}` | `imagenumfaces<${number}` | `imagenumfaces=${number}` | `imagewebcount>${number}` | `imagewebcount<${number}`;
+/**
+ * Template literal types for proximity queries
+ */
+export type ProximityQuery = `near${number}:"${string}"`;
+/**
+ * Template literal types for repeat queries
+ */
+export type RepeatQuery = `repeat${number}:"${string}"`;
+/**
+ * Template literal types for theme queries
+ */
+export type ThemeQuery = `theme:${string}`;
+/**
+ * Utility type for creating strongly typed query builders
+ */
+export type QueryComponent = string | ToneQuery | DomainQuery | SourceQuery | ImageQuery | ProximityQuery | RepeatQuery | ThemeQuery;
+/**
+ * Utility type for boolean OR queries
+ */
+export type BooleanOrQuery<T extends string = string> = `(${T}${` OR ${T}`})`;
+/**
+ * Utility type for phrase queries
+ */
+export type PhraseQuery<T extends string = string> = `"${T}"`;
+/**
+ * Utility type for negation queries
+ */
+export type NegationQuery<T extends QueryComponent = QueryComponent> = `-${T}`;
+/**
+ * Complex query type that combines multiple query components
+ */
+export type ComplexQuery = QueryComponent | BooleanOrQuery<string> | PhraseQuery<string> | NegationQuery<QueryComponent> | `${QueryComponent} AND ${QueryComponent}` | `${QueryComponent} OR ${QueryComponent}` | `${QueryComponent} NOT ${QueryComponent}`;
+/**
+ * Parameters specific to article list modes
+ */
+export interface ArticleListParams {
+    maxrecords?: number;
+    sort?: SortOrderType;
+}
+/**
+ * Parameters specific to timeline modes
+ */
+export interface TimelineParams {
+    timelinesmooth?: number;
+    timezoom?: 'yes' | 'no';
+}
+/**
+ * Parameters specific to image modes
+ */
+export interface ImageParams {
+    maxrecords?: number;
+}
+/**
+ * Conditional parameter types based on mode
+ */
+export type ModeSpecificParams<T extends ModeType> = T extends typeof Mode.ARTICLE_LIST | typeof Mode.ARTICLE_GALLERY ? ArticleListParams : T extends typeof Mode.TIMELINE_VOLUME | typeof Mode.TIMELINE_VOLUME_RAW | typeof Mode.TIMELINE_VOLUME_INFO | typeof Mode.TIMELINE_TONE | typeof Mode.TIMELINE_LANGUAGE | typeof Mode.TIMELINE_SOURCE_COUNTRY ? TimelineParams : T extends typeof Mode.IMAGE_COLLAGE | typeof Mode.IMAGE_COLLAGE_INFO | typeof Mode.IMAGE_GALLERY | typeof Mode.IMAGE_COLLAGE_SHARE ? ImageParams : Record<string, never>;
+/**
+ * Enhanced base parameters with stronger typing
+ */
+export interface EnhancedGdeltApiParams<TMode extends ModeType = ModeType> {
+    /**
+     * The search query with enhanced type validation
+     */
+    query: string | ComplexQuery;
+    /**
+     * The output mode with const assertion types
+     */
+    mode?: TMode;
+    /**
+     * The output format with const assertion types
+     */
+    format?: FormatType;
+    /**
+     * Strongly typed timespan parameter
+     */
+    timespan?: TimespanString;
+    /**
+     * Strongly typed start datetime
+     */
+    startdatetime?: DateTimeString;
+    /**
+     * Strongly typed end datetime
+     */
+    enddatetime?: DateTimeString;
+    /**
+     * Translation options
+     */
+    trans?: 'googtrans';
+    /**
+     * JSONP callback (only when format is JSONP)
+     */
+    callback?: FormatType extends typeof Format.JSONP ? string : never;
+}
+/**
+ * Complete parameter type that combines base params with mode-specific params
+ */
+export type CompleteGdeltApiParams<TMode extends ModeType = ModeType> = EnhancedGdeltApiParams<TMode> & ModeSpecificParams<TMode>;
+/**
+ * Utility type for extracting the return type based on mode
+ */
+export type ResponseTypeForMode<T extends ModeType> = T extends typeof Mode.ARTICLE_LIST | typeof Mode.ARTICLE_GALLERY ? 'ArticleListResponse' : T extends typeof Mode.IMAGE_COLLAGE | typeof Mode.IMAGE_COLLAGE_INFO | typeof Mode.IMAGE_GALLERY | typeof Mode.IMAGE_COLLAGE_SHARE ? 'ImageResponse' : T extends typeof Mode.TIMELINE_VOLUME | typeof Mode.TIMELINE_VOLUME_RAW | typeof Mode.TIMELINE_VOLUME_INFO | typeof Mode.TIMELINE_TONE ? 'TimelineResponse' : T extends typeof Mode.TIMELINE_LANGUAGE | typeof Mode.TIMELINE_SOURCE_COUNTRY ? 'TimelineBreakdownResponse' : T extends typeof Mode.TONE_CHART ? 'ToneChartResponse' : T extends typeof Mode.WORD_CLOUD_IMAGE_TAGS | typeof Mode.WORD_CLOUD_IMAGE_WEB_TAGS ? 'WordCloudResponse' : 'UnknownResponse';
+/**
+ * Utility type for creating type-safe method overloads
+ */
+export interface MethodOverload<TParams, TReturn> {
+    (params: TParams): Promise<TReturn>;
+    (query: string): Promise<TReturn>;
+    (query: string, options: Partial<TParams>): Promise<TReturn>;
+}
+/**
+ * Branded type for validated queries
+ */
+export type ValidatedQuery = string & {
+    readonly __brand: 'ValidatedQuery';
+};
+/**
+ * Branded type for validated timespan
+ */
+export type ValidatedTimespan = string & {
+    readonly __brand: 'ValidatedTimespan';
+};
+/**
+ * Branded type for validated datetime
+ */
+export type ValidatedDateTime = string & {
+    readonly __brand: 'ValidatedDateTime';
+};
+/**
+ * Type predicate for validating timespan format
+ */
+export declare function isValidTimespan(value: string): value is TimespanString;
+/**
+ * Type predicate for validating datetime format
+ */
+export declare function isValidDateTime(value: string): value is DateTimeString;
+/**
+ * Type predicate for validating maxrecords range
+ */
+export declare function isValidMaxRecords(value: number): value is number;
+/**
+ * Type predicate for validating timelinesmooth range
+ */
+export declare function isValidTimelineSmooth(value: number): value is number;
+//# sourceMappingURL=enhanced-types.d.ts.map

package/dist/types/enhanced-types.d.ts.map

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

package/dist/types/enhanced-types.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Enhanced types for better developer experience and type safety
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SortOrder = exports.TimespanUnit = exports.Format = exports.Mode = void 0;
+exports.isValidTimespan = isValidTimespan;
+exports.isValidDateTime = isValidDateTime;
+exports.isValidMaxRecords = isValidMaxRecords;
+exports.isValidTimelineSmooth = isValidTimelineSmooth;
+/* eslint-disable @typescript-eslint/naming-convention */
+/**
+ * Mode constants using const assertions for better IntelliSense and extensibility
+ */
+exports.Mode = {
+    ARTICLE_LIST: 'artlist',
+    ARTICLE_GALLERY: 'artgallery',
+    IMAGE_COLLAGE: 'imagecollage',
+    IMAGE_COLLAGE_INFO: 'imagecollageinfo',
+    IMAGE_GALLERY: 'imagegallery',
+    IMAGE_COLLAGE_SHARE: 'imagecollagesshare',
+    TIMELINE_VOLUME: 'timelinevol',
+    TIMELINE_VOLUME_RAW: 'timelinevolraw',
+    TIMELINE_VOLUME_INFO: 'timelinevolinfo',
+    TIMELINE_TONE: 'timelinetone',
+    TIMELINE_LANGUAGE: 'timelinelang',
+    TIMELINE_SOURCE_COUNTRY: 'timelinesourcecountry',
+    TONE_CHART: 'tonechart',
+    WORD_CLOUD_IMAGE_TAGS: 'wordcloudimagetags',
+    WORD_CLOUD_IMAGE_WEB_TAGS: 'wordcloudimagewebtags'
+};
+/**
+ * Format constants using const assertions
+ */
+exports.Format = {
+    HTML: 'html',
+    CSV: 'csv',
+    RSS: 'rss',
+    RSS_ARCHIVE: 'rssarchive',
+    JSON: 'json',
+    JSONP: 'jsonp',
+    JSON_FEED: 'jsonfeed'
+};
+/**
+ * Timespan unit constants using const assertions
+ */
+exports.TimespanUnit = {
+    MINUTES: 'min',
+    HOURS: 'h',
+    DAYS: 'd',
+    WEEKS: 'w',
+    MONTHS: 'm'
+};
+/**
+ * Sort option constants using const assertions
+ */
+exports.SortOrder = {
+    DATE_DESC: 'datedesc',
+    DATE_ASC: 'dateasc',
+    TONE_DESC: 'tonedesc',
+    TONE_ASC: 'toneasc',
+    HYBRID_RELEVANCE: 'hybridrel'
+};
+// ===== TYPE PREDICATES AND GUARDS =====
+/**
+ * Type predicate for validating timespan format
+ */
+function isValidTimespan(value) {
+    return /^\d+(min|h|d|w|m)$/.test(value);
+}
+/**
+ * Type predicate for validating datetime format
+ */
+function isValidDateTime(value) {
+    return /^\d{14}$/.test(value);
+}
+/**
+ * Type predicate for validating maxrecords range
+ */
+function isValidMaxRecords(value) {
+    return Number.isInteger(value) && value >= 1 && value <= 250;
+}
+/**
+ * Type predicate for validating timelinesmooth range
+ */
+function isValidTimelineSmooth(value) {
+    return Number.isInteger(value) && value >= 1 && value <= 30;
+}
+//# sourceMappingURL=enhanced-types.js.map

package/dist/types/enhanced-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhanced-types.js","sourceRoot":"","sources":["../../src/types/enhanced-types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAwTH,0CAEC;AAKD,0CAEC;AAKD,8CAEC;AAKD,sDAEC;AA7UD,yDAAyD;AAEzD;;GAEG;AACU,QAAA,IAAI,GAAG;IAClB,YAAY,EAAE,SAAS;IACvB,eAAe,EAAE,YAAY;IAC7B,aAAa,EAAE,cAAc;IAC7B,kBAAkB,EAAE,kBAAkB;IACtC,aAAa,EAAE,cAAc;IAC7B,mBAAmB,EAAE,oBAAoB;IACzC,eAAe,EAAE,aAAa;IAC9B,mBAAmB,EAAE,gBAAgB;IACrC,oBAAoB,EAAE,iBAAiB;IACvC,aAAa,EAAE,cAAc;IAC7B,iBAAiB,EAAE,cAAc;IACjC,uBAAuB,EAAE,uBAAuB;IAChD,UAAU,EAAE,WAAW;IACvB,qBAAqB,EAAE,oBAAoB;IAC3C,yBAAyB,EAAE,uBAAuB;CAC1C,CAAC;AAIX;;GAEG;AACU,QAAA,MAAM,GAAG;IACpB,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,WAAW,EAAE,YAAY;IACzB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,UAAU;CACb,CAAC;AAIX;;GAEG;AACU,QAAA,YAAY,GAAG;IAC1B,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,GAAG;IACV,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,MAAM,EAAE,GAAG;CACH,CAAC;AAIX;;GAEG;AACU,QAAA,SAAS,GAAG;IACvB,SAAS,EAAE,UAAU;IACrB,QAAQ,EAAE,SAAS;IACnB,SAAS,EAAE,UAAU;IACrB,QAAQ,EAAE,SAAS;IACnB,gBAAgB,EAAE,WAAW;CACrB,CAAC;AAmPX,yCAAyC;AAEzC;;GAEG;AACH,SAAgB,eAAe,CAAC,KAAa;IAC3C,OAAO,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,KAAa;IAC3C,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,KAAa;IAC7C,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,GAAG,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,KAAa;IACjD,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;AAC9D,CAAC"}