@gscdump/sdk 1.0.0 → 1.0.2

package/README.md

@@ -10,22 +10,8 @@ Consumer SDK for hosted gscdump.com integrations.
 
 This package is for partner applications that consume gscdump.com APIs,
 webhooks, and realtime events. Callers inject the HTTP transport and auth they
-want to use; route construction stays inside the hosted adapter.
-
-```ts
-import { createPartnerClient } from '@gscdump/sdk'
-
-const gscdump = createPartnerClient({
-  apiBase: 'https://example.com/api',
-  apiKey: process.env.GSCDUMP_API_KEY,
-  fetch: $fetch,
-})
-
-const { sites } = await gscdump.getUserSites(userId)
-```
-
-The initial v1 slice uses a server-held Bearer credential and exposes both a
-generic operation executor and four convenience methods:
+want to use; route construction stays inside the hosted adapter. New hosted
+HTTP integrations should import the stable v1 client:
 
 ```ts
 import { createGscdumpV1Client } from '@gscdump/sdk/v1'
@@ -40,6 +26,23 @@ const lifecycle = await gscdump.getUserLifecycle({
 })
 ```
 
+The v1 surface uses a server-held Bearer credential and exposes a generic
+operation executor plus typed convenience methods for all 18 registered HTTP
+operations across partner, analytics, and realtime.
+
+The root `createPartnerClient` export remains only for operations still in the
+compatibility inventory. Do not use it for an operation already available from
+`@gscdump/sdk/v1`.
+
+For example, a typed hosted report query is:
+
+```ts
+const report = await gscdump.queryAnalyticsReport({
+  params: { siteId: 's_01' },
+  body: { state: { dimensions: ['query'], searchType: 'web' } },
+})
+```
+
 ## Scope
 
 - Partner user lifecycle

package/dist/index.mjs

@@ -5,7 +5,13 @@ import { entityDailyTimeseries, multiSeriesStackedDaily, siteDailyTimeseries, to
 import { extractDateRange, normalizeFilter } from "gscdump/query";
 import { partnerEndpoints } from "@gscdump/contracts/partner";
 import { resolveWindow } from "@gscdump/engine/period";
-import { endOfMonth, format, startOfMonth, startOfQuarter, startOfWeek, subDays, subMonths } from "date-fns";
+import { endOfMonth } from "date-fns/endOfMonth";
+import { format } from "date-fns/format";
+import { startOfMonth } from "date-fns/startOfMonth";
+import { startOfQuarter } from "date-fns/startOfQuarter";
+import { startOfWeek } from "date-fns/startOfWeek";
+import { subDays } from "date-fns/subDays";
+import { subMonths } from "date-fns/subMonths";
 import { CANONICAL_WEBHOOK_EVENTS, VALID_WEBHOOK_EVENTS, WEBHOOK_CONTRACT_VERSION, WEBHOOK_CONTRACT_VERSION_HEADER, WEBHOOK_CONTRACT_VERSION_HEADER as WEBHOOK_CONTRACT_VERSION_HEADER$1, WEBHOOK_DELIVERY_HEADER, WEBHOOK_DELIVERY_HEADER as WEBHOOK_DELIVERY_HEADER$1, WEBHOOK_EVENT_HEADER, WEBHOOK_EVENT_HEADER as WEBHOOK_EVENT_HEADER$1, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_SIGNATURE_HEADER as WEBHOOK_SIGNATURE_HEADER$1, WEBHOOK_TIMESTAMP_HEADER, WEBHOOK_TIMESTAMP_HEADER as WEBHOOK_TIMESTAMP_HEADER$1, partnerWebhookEnvelopeSchema } from "@gscdump/contracts";
 const DEFAULT_SEARCH_TYPE = "web";
 function isAnalysisSourcesOptions(value) {

package/dist/v1/index.d.mts

@@ -92,7 +92,7 @@ interface GscdumpV1Client {
 /** Create one framework-neutral client whose behavior is driven by the v1 registry. */
 declare function createGscdumpV1Client(options: CreateGscdumpV1ClientOptions): GscdumpV1Client;
 type MaybePromise<T> = T | Promise<T>;
-declare const GSCDUMP_REALTIME_V1_SDK_VERSION: "0.37.7";
+declare const GSCDUMP_REALTIME_V1_SDK_VERSION: "1.0.2";
 type GscdumpRealtimeV1TransportState = 'idle' | 'ticketing' | 'connecting' | 'handshaking' | 'replaying' | 'live' | 'waiting' | 'stopped' | 'terminal';
 type GscdumpRealtimeV1Freshness = 'unknown' | 'stale' | 'applying' | 'fresh' | 'resyncing' | 'degraded';
 type GscdumpRealtimeV1ErrorCode = 'cursor_store_failed' | 'effect_failed' | 'heartbeat_stale' | 'integration_failed' | 'protocol_error' | 'resync_failed' | 'runtime_unavailable' | 'socket_error' | 'ticket_invalid' | 'ticket_provider_failed' | 'upgrade_rejected';

package/dist/v1/index.mjs

@@ -395,7 +395,7 @@ function utf8Size(value) {
 	}
 	return bytes;
 }
-const GSCDUMP_REALTIME_V1_SDK_VERSION = "0.37.7";
+const GSCDUMP_REALTIME_V1_SDK_VERSION = "1.0.2";
 var GscdumpRealtimeV1Error = class extends Error {
 	tag = "GscdumpRealtimeV1Error";
 	code;
@@ -482,7 +482,7 @@ function createGscdumpRealtimeV1Client(options) {
 	const protocol = createGscdumpV1Protocol();
 	const runtime = options.runtime ?? defaultRuntime();
 	const cursorStore = options.cursorStore ?? createMemoryCursorStore();
-	const sdkVersion = options.sdkVersion ?? "0.37.7";
+	const sdkVersion = options.sdkVersion ?? "1.0.2";
 	if (!sdkVersion) throw new TypeError("sdkVersion cannot be empty.");
 	let running = false;
 	let epoch = 0;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/sdk",
   "type": "module",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Consumer SDK for hosted gscdump.com integrations.",
   "author": {
     "name": "Harlan Wilton",
@@ -44,10 +44,10 @@
     "date-fns": "^4.4.0",
     "ofetch": "^1.5.1",
     "zod": "^4.4.3",
-    "@gscdump/contracts": "^1.0.0",
-    "@gscdump/analysis": "^1.0.0",
-    "@gscdump/engine": "^1.0.0",
-    "gscdump": "^1.0.0"
+    "@gscdump/contracts": "^1.0.2",
+    "@gscdump/analysis": "^1.0.2",
+    "gscdump": "^1.0.2",
+    "@gscdump/engine": "^1.0.2"
   },
   "devDependencies": {
     "typescript": "^6.0.3",