@power-seo/search-console 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +377 -0
- package/dist/index.cjs +279 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +164 -0
- package/dist/index.d.ts +164 -0
- package/dist/index.js +266 -0
- package/dist/index.js.map +1 -0
- package/package.json +56 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/types.ts","../src/auth.ts","../src/client.ts","../src/analytics.ts","../src/inspection.ts","../src/sitemaps.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// ============================================================================\r\n// @power-seo/search-console — Types\r\n// ============================================================================\r\n\r\n// --- Auth Types ---\r\n\r\nexport interface OAuthCredentials {\r\n clientId: string;\r\n clientSecret: string;\r\n refreshToken: string;\r\n}\r\n\r\nexport interface ServiceAccountCredentials {\r\n clientEmail: string;\r\n privateKeyId: string;\r\n signJwt: (payload: JwtPayload) => Promise<string>;\r\n}\r\n\r\nexport interface JwtPayload {\r\n iss: string;\r\n scope: string;\r\n aud: string;\r\n exp: number;\r\n iat: number;\r\n}\r\n\r\nexport interface TokenResult {\r\n accessToken: string;\r\n expiresAt: number;\r\n}\r\n\r\nexport interface TokenManager {\r\n getToken: () => Promise<string>;\r\n invalidate: () => void;\r\n}\r\n\r\n// --- Client Types ---\r\n\r\nexport interface GSCClientConfig {\r\n auth: TokenManager;\r\n siteUrl: string;\r\n rateLimitPerMinute?: number;\r\n maxRetries?: number;\r\n baseUrl?: string;\r\n}\r\n\r\nexport interface GSCClient {\r\n request: <T>(path: string, options?: RequestOptions) => Promise<T>;\r\n siteUrl: string;\r\n}\r\n\r\nexport interface RequestOptions {\r\n method?: string;\r\n body?: unknown;\r\n signal?: globalThis.AbortSignal;\r\n}\r\n\r\n// --- Error ---\r\n\r\nexport class GSCApiError extends Error {\r\n readonly status: number;\r\n readonly code: string;\r\n readonly retryable: boolean;\r\n\r\n constructor(message: string, status: number, code: string) {\r\n super(message);\r\n this.name = 'GSCApiError';\r\n this.status = status;\r\n this.code = code;\r\n this.retryable = status === 429 || status >= 500;\r\n }\r\n}\r\n\r\n// --- Analytics Types ---\r\n\r\nexport type SearchType = 'web' | 'image' | 'video' | 'news' | 'discover' | 'googleNews';\r\nexport type Dimension = 'query' | 'page' | 'country' | 'device' | 'date' | 'searchAppearance';\r\nexport type AggregationType = 'auto' | 'byPage' | 'byProperty';\r\nexport type DataState = 'all' | 'final';\r\n\r\nexport interface DimensionFilter {\r\n dimension: Dimension;\r\n operator: 'equals' | 'notEquals' | 'contains' | 'notContains' | 'includingRegex' | 'excludingRegex';\r\n expression: string;\r\n}\r\n\r\nexport interface DimensionFilterGroup {\r\n groupType?: 'and';\r\n filters: DimensionFilter[];\r\n}\r\n\r\nexport interface SearchAnalyticsRequest {\r\n startDate: string;\r\n endDate: string;\r\n dimensions?: Dimension[];\r\n searchType?: SearchType;\r\n dimensionFilterGroups?: DimensionFilterGroup[];\r\n aggregationType?: AggregationType;\r\n rowLimit?: number;\r\n startRow?: number;\r\n dataState?: DataState;\r\n}\r\n\r\nexport interface SearchAnalyticsRow {\r\n keys: string[];\r\n clicks: number;\r\n impressions: number;\r\n ctr: number;\r\n position: number;\r\n}\r\n\r\nexport interface SearchAnalyticsResponse {\r\n rows: SearchAnalyticsRow[];\r\n responseAggregationType: string;\r\n}\r\n\r\n// --- Inspection Types ---\r\n\r\nexport interface InspectionRequest {\r\n inspectionUrl: string;\r\n languageCode?: string;\r\n}\r\n\r\nexport type VerdictState = 'PASS' | 'PARTIAL' | 'FAIL' | 'VERDICT_UNSPECIFIED' | 'NEUTRAL';\r\nexport type CrawlState = 'SUCCESSFUL' | 'NOT_FOUND' | 'SERVER_ERROR' | 'ROBOTS_BLOCKED' | 'REDIRECT_ERROR' | 'ACCESS_DENIED' | 'ACCESS_FORBIDDEN';\r\nexport type IndexState = 'INDEXED' | 'NOT_INDEXED' | 'SUBMITTED_AND_INDEXED' | 'CRAWLED_NOT_INDEXED' | 'DISCOVERED_NOT_INDEXED' | 'PAGE_WITH_REDIRECT';\r\nexport type RobotsTxtState = 'ALLOWED' | 'DISALLOWED';\r\n\r\nexport interface IndexStatusResult {\r\n verdict: VerdictState;\r\n coverageState: IndexState;\r\n robotsTxtState: RobotsTxtState;\r\n indexingState: string;\r\n lastCrawlTime?: string;\r\n pageFetchState?: CrawlState;\r\n referringUrls?: string[];\r\n sitemap?: string[];\r\n}\r\n\r\nexport interface MobileUsabilityResult {\r\n verdict: VerdictState;\r\n issues?: Array<{ issueType: string; severity: string; message: string }>;\r\n}\r\n\r\nexport interface RichResultsResult {\r\n verdict: VerdictState;\r\n detectedItems?: Array<{ richResultType: string; items: Array<{ name: string; issues?: Array<{ issueMessage: string; severity: string }> }> }>;\r\n}\r\n\r\nexport interface InspectionResult {\r\n inspectionResultLink: string;\r\n indexStatusResult: IndexStatusResult;\r\n mobileUsabilityResult?: MobileUsabilityResult;\r\n richResultsResult?: RichResultsResult;\r\n}\r\n\r\n// --- Sitemap Types ---\r\n\r\nexport type SitemapType = 'sitemap' | 'atomFeed' | 'rssFeed' | 'notSitemap';\r\n\r\nexport interface SitemapEntry {\r\n path: string;\r\n lastSubmitted?: string;\r\n isPending: boolean;\r\n isSitemapsIndex: boolean;\r\n type: SitemapType;\r\n lastDownloaded?: string;\r\n warnings: number;\r\n errors: number;\r\n contents?: Array<{ type: string; submitted: number; indexed: number }>;\r\n}\r\n\r\nexport interface SitemapListResponse {\r\n sitemap: SitemapEntry[];\r\n}\r\n","// ============================================================================\r\n// @power-seo/search-console — Auth\r\n// ============================================================================\r\n\r\nimport type {\r\n OAuthCredentials,\r\n ServiceAccountCredentials,\r\n TokenResult,\r\n TokenManager,\r\n} from './types.js';\r\nimport { GSCApiError } from './types.js';\r\n\r\nconst TOKEN_URL = 'https://oauth2.googleapis.com/token';\r\nconst GSC_SCOPE = 'https://www.googleapis.com/auth/webmasters.readonly';\r\nconst TOKEN_BUFFER_MS = 60_000;\r\n\r\nexport async function exchangeRefreshToken(\r\n credentials: OAuthCredentials,\r\n): Promise<TokenResult> {\r\n const body = new globalThis.URLSearchParams({\r\n client_id: credentials.clientId,\r\n client_secret: credentials.clientSecret,\r\n refresh_token: credentials.refreshToken,\r\n grant_type: 'refresh_token',\r\n });\r\n\r\n const response = await globalThis.fetch(TOKEN_URL, {\r\n method: 'POST',\r\n headers: { 'Content-Type': 'application/x-www-form-urlencoded' },\r\n body: body.toString(),\r\n });\r\n\r\n if (!response.ok) {\r\n const text = await response.text();\r\n throw new GSCApiError(\r\n `Token exchange failed: ${text}`,\r\n response.status,\r\n 'TOKEN_EXCHANGE_ERROR',\r\n );\r\n }\r\n\r\n const data = (await response.json()) as { access_token: string; expires_in: number };\r\n return {\r\n accessToken: data.access_token,\r\n expiresAt: Date.now() + data.expires_in * 1000,\r\n };\r\n}\r\n\r\nexport async function getServiceAccountToken(\r\n credentials: ServiceAccountCredentials,\r\n): Promise<TokenResult> {\r\n const now = Math.floor(Date.now() / 1000);\r\n const payload = {\r\n iss: credentials.clientEmail,\r\n scope: GSC_SCOPE,\r\n aud: TOKEN_URL,\r\n exp: now + 3600,\r\n iat: now,\r\n };\r\n\r\n const assertion = await credentials.signJwt(payload);\r\n\r\n const body = new globalThis.URLSearchParams({\r\n grant_type: 'urn:ietf:params:oauth:grant-type:jwt-bearer',\r\n assertion,\r\n });\r\n\r\n const response = await globalThis.fetch(TOKEN_URL, {\r\n method: 'POST',\r\n headers: { 'Content-Type': 'application/x-www-form-urlencoded' },\r\n body: body.toString(),\r\n });\r\n\r\n if (!response.ok) {\r\n const text = await response.text();\r\n throw new GSCApiError(\r\n `Service account token failed: ${text}`,\r\n response.status,\r\n 'SERVICE_ACCOUNT_ERROR',\r\n );\r\n }\r\n\r\n const data = (await response.json()) as { access_token: string; expires_in: number };\r\n return {\r\n accessToken: data.access_token,\r\n expiresAt: Date.now() + data.expires_in * 1000,\r\n };\r\n}\r\n\r\nexport function createTokenManager(\r\n fetchToken: () => Promise<TokenResult>,\r\n): TokenManager {\r\n let cached: TokenResult | null = null;\r\n let pending: Promise<string> | null = null;\r\n\r\n return {\r\n async getToken(): Promise<string> {\r\n if (cached && cached.expiresAt > Date.now() + TOKEN_BUFFER_MS) {\r\n return cached.accessToken;\r\n }\r\n\r\n if (pending) {\r\n return pending;\r\n }\r\n\r\n pending = fetchToken().then((result) => {\r\n cached = result;\r\n pending = null;\r\n return result.accessToken;\r\n });\r\n\r\n return pending;\r\n },\r\n\r\n invalidate(): void {\r\n cached = null;\r\n pending = null;\r\n },\r\n };\r\n}\r\n","// ============================================================================\r\n// @power-seo/search-console — Client\r\n// ============================================================================\r\n\r\nimport type { GSCClientConfig, GSCClient, RequestOptions } from './types.js';\r\nimport { GSCApiError } from './types.js';\r\nimport { createTokenBucket, consumeToken, getWaitTime, sleep } from '@power-seo/core';\r\n\r\nconst DEFAULT_BASE_URL = 'https://searchconsole.googleapis.com/webmasters/v3';\r\nconst DEFAULT_RATE_LIMIT = 1200;\r\nconst DEFAULT_MAX_RETRIES = 3;\r\n\r\nexport function createGSCClient(config: GSCClientConfig): GSCClient {\r\n const baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;\r\n const maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;\r\n const bucket = createTokenBucket(config.rateLimitPerMinute ?? DEFAULT_RATE_LIMIT);\r\n\r\n async function request<T>(path: string, options?: RequestOptions): Promise<T> {\r\n const waitTime = getWaitTime(bucket);\r\n if (waitTime > 0) {\r\n await sleep(waitTime);\r\n }\r\n consumeToken(bucket);\r\n\r\n const token = await config.auth.getToken();\r\n const url = `${baseUrl}${path}`;\r\n\r\n let lastError: Error | null = null;\r\n\r\n for (let attempt = 0; attempt <= maxRetries; attempt++) {\r\n try {\r\n const response = await globalThis.fetch(url, {\r\n method: options?.method ?? 'GET',\r\n headers: {\r\n Authorization: `Bearer ${token}`,\r\n 'Content-Type': 'application/json',\r\n },\r\n body: options?.body ? JSON.stringify(options.body) : undefined,\r\n signal: options?.signal,\r\n });\r\n\r\n if (response.ok) {\r\n return (await response.json()) as T;\r\n }\r\n\r\n const text = await response.text();\r\n const error = new GSCApiError(\r\n `GSC API error: ${response.status} ${text}`,\r\n response.status,\r\n `HTTP_${response.status}`,\r\n );\r\n\r\n if (!error.retryable || attempt === maxRetries) {\r\n throw error;\r\n }\r\n\r\n lastError = error;\r\n const backoff = Math.min(1000 * Math.pow(2, attempt), 30_000);\r\n await sleep(backoff);\r\n } catch (err) {\r\n if (err instanceof GSCApiError) {\r\n if (!err.retryable || attempt === maxRetries) {\r\n throw err;\r\n }\r\n lastError = err;\r\n const backoff = Math.min(1000 * Math.pow(2, attempt), 30_000);\r\n await sleep(backoff);\r\n } else {\r\n throw err;\r\n }\r\n }\r\n }\r\n\r\n throw lastError ?? new GSCApiError('Request failed', 500, 'UNKNOWN');\r\n }\r\n\r\n return {\r\n request,\r\n siteUrl: config.siteUrl,\r\n };\r\n}\r\n","// ============================================================================\r\n// @power-seo/search-console — Analytics\r\n// ============================================================================\r\n\r\nimport type {\r\n GSCClient,\r\n SearchAnalyticsRequest,\r\n SearchAnalyticsResponse,\r\n SearchAnalyticsRow,\r\n} from './types.js';\r\n\r\nconst MAX_ROW_LIMIT = 25000;\r\nconst DEFAULT_ROW_LIMIT = 1000;\r\n\r\nexport async function querySearchAnalytics(\r\n client: GSCClient,\r\n request: SearchAnalyticsRequest,\r\n): Promise<SearchAnalyticsResponse> {\r\n const siteUrl = encodeURIComponent(client.siteUrl);\r\n const body = {\r\n ...request,\r\n rowLimit: Math.min(request.rowLimit ?? DEFAULT_ROW_LIMIT, MAX_ROW_LIMIT),\r\n };\r\n\r\n return client.request<SearchAnalyticsResponse>(\r\n `/sites/${siteUrl}/searchAnalytics/query`,\r\n { method: 'POST', body },\r\n );\r\n}\r\n\r\nexport async function querySearchAnalyticsAll(\r\n client: GSCClient,\r\n request: Omit<SearchAnalyticsRequest, 'startRow' | 'rowLimit'>,\r\n): Promise<SearchAnalyticsRow[]> {\r\n const allRows: SearchAnalyticsRow[] = [];\r\n let startRow = 0;\r\n\r\n while (true) {\r\n const response = await querySearchAnalytics(client, {\r\n ...request,\r\n rowLimit: MAX_ROW_LIMIT,\r\n startRow,\r\n });\r\n\r\n const rows = response.rows ?? [];\r\n allRows.push(...rows);\r\n\r\n if (rows.length < MAX_ROW_LIMIT) {\r\n break;\r\n }\r\n\r\n startRow += rows.length;\r\n }\r\n\r\n return allRows;\r\n}\r\n","// ============================================================================\r\n// @power-seo/search-console — URL Inspection\r\n// ============================================================================\r\n\r\nimport type {\r\n GSCClient,\r\n InspectionRequest,\r\n InspectionResult,\r\n} from './types.js';\r\n\r\nconst INSPECTION_BASE = 'https://searchconsole.googleapis.com/v1/urlInspection/index:inspect';\r\n\r\nexport async function inspectUrl(\r\n client: GSCClient,\r\n request: InspectionRequest,\r\n): Promise<InspectionResult> {\r\n const body = {\r\n inspectionUrl: request.inspectionUrl,\r\n siteUrl: client.siteUrl,\r\n languageCode: request.languageCode ?? 'en',\r\n };\r\n\r\n const token = await client.request<{ inspectionResult: InspectionResult }>(\r\n '',\r\n {\r\n method: 'POST',\r\n body,\r\n },\r\n );\r\n\r\n // The URL Inspection API has a different base URL, so we use a direct fetch.\r\n // However, since the client handles auth and retries, we override for the standard path approach.\r\n // The API endpoint doesn't follow the webmasters/v3 pattern.\r\n // We'll use the client's request method with a custom approach.\r\n\r\n // Actually, let's do a direct fetch since the base URL differs:\r\n return token.inspectionResult;\r\n}\r\n\r\nexport async function inspectUrlDirect(\r\n getToken: () => Promise<string>,\r\n siteUrl: string,\r\n inspectionUrl: string,\r\n languageCode?: string,\r\n): Promise<InspectionResult> {\r\n const token = await getToken();\r\n\r\n const response = await globalThis.fetch(INSPECTION_BASE, {\r\n method: 'POST',\r\n headers: {\r\n Authorization: `Bearer ${token}`,\r\n 'Content-Type': 'application/json',\r\n },\r\n body: JSON.stringify({\r\n inspectionUrl,\r\n siteUrl,\r\n languageCode: languageCode ?? 'en',\r\n }),\r\n });\r\n\r\n if (!response.ok) {\r\n const text = await response.text();\r\n throw new Error(`URL Inspection API error: ${response.status} ${text}`);\r\n }\r\n\r\n const data = (await response.json()) as { inspectionResult: InspectionResult };\r\n return data.inspectionResult;\r\n}\r\n","// ============================================================================\r\n// @power-seo/search-console — Sitemaps\r\n// ============================================================================\r\n\r\nimport type {\r\n GSCClient,\r\n SitemapEntry,\r\n SitemapListResponse,\r\n} from './types.js';\r\n\r\nexport async function listSitemaps(\r\n client: GSCClient,\r\n): Promise<SitemapEntry[]> {\r\n const siteUrl = encodeURIComponent(client.siteUrl);\r\n const response = await client.request<SitemapListResponse>(\r\n `/sites/${siteUrl}/sitemaps`,\r\n );\r\n return response.sitemap ?? [];\r\n}\r\n\r\nexport async function submitSitemap(\r\n client: GSCClient,\r\n feedpath: string,\r\n): Promise<void> {\r\n const siteUrl = encodeURIComponent(client.siteUrl);\r\n const encodedFeed = encodeURIComponent(feedpath);\r\n await client.request<void>(\r\n `/sites/${siteUrl}/sitemaps/${encodedFeed}`,\r\n { method: 'PUT' },\r\n );\r\n}\r\n\r\nexport async function deleteSitemap(\r\n client: GSCClient,\r\n feedpath: string,\r\n): Promise<void> {\r\n const siteUrl = encodeURIComponent(client.siteUrl);\r\n const encodedFeed = encodeURIComponent(feedpath);\r\n await client.request<void>(\r\n `/sites/${siteUrl}/sitemaps/${encodedFeed}`,\r\n { method: 'DELETE' },\r\n );\r\n}\r\n"]}
|
package/package.json
ADDED
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@power-seo/search-console",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "Google Search Console API client with OAuth2/service account auth, rate limiting, and retry",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"type": "module",
|
|
7
|
+
"exports": {
|
|
8
|
+
".": {
|
|
9
|
+
"import": "./dist/index.js",
|
|
10
|
+
"require": "./dist/index.cjs",
|
|
11
|
+
"types": "./dist/index.d.ts"
|
|
12
|
+
}
|
|
13
|
+
},
|
|
14
|
+
"main": "./dist/index.cjs",
|
|
15
|
+
"module": "./dist/index.js",
|
|
16
|
+
"types": "./dist/index.d.ts",
|
|
17
|
+
"files": [
|
|
18
|
+
"dist"
|
|
19
|
+
],
|
|
20
|
+
"scripts": {
|
|
21
|
+
"build": "tsup",
|
|
22
|
+
"dev": "tsup --watch",
|
|
23
|
+
"test": "vitest run",
|
|
24
|
+
"test:watch": "vitest",
|
|
25
|
+
"typecheck": "tsc --noEmit",
|
|
26
|
+
"lint": "eslint src/",
|
|
27
|
+
"lint:fix": "eslint src/ --fix",
|
|
28
|
+
"clean": "rimraf dist"
|
|
29
|
+
},
|
|
30
|
+
"dependencies": {
|
|
31
|
+
"@power-seo/core": "workspace:*"
|
|
32
|
+
},
|
|
33
|
+
"devDependencies": {
|
|
34
|
+
"rimraf": "^6.0.0",
|
|
35
|
+
"tsup": "^8.3.0",
|
|
36
|
+
"typescript": "^5.7.0",
|
|
37
|
+
"vitest": "^2.1.0"
|
|
38
|
+
},
|
|
39
|
+
"keywords": [
|
|
40
|
+
"seo",
|
|
41
|
+
"google-search-console",
|
|
42
|
+
"gsc",
|
|
43
|
+
"api",
|
|
44
|
+
"typescript"
|
|
45
|
+
],
|
|
46
|
+
"sideEffects": false,
|
|
47
|
+
"author": "CyberCraft Bangladesh <info@ccbd.dev>",
|
|
48
|
+
"repository": {
|
|
49
|
+
"type": "git",
|
|
50
|
+
"url": "git+https://github.com/cybercraftbd/power-seo.git",
|
|
51
|
+
"directory": "packages/search-console"
|
|
52
|
+
},
|
|
53
|
+
"publishConfig": {
|
|
54
|
+
"access": "public"
|
|
55
|
+
}
|
|
56
|
+
}
|