@lobu/connector-sdk 6.0.1

package/dist/identity-types.js

@@ -0,0 +1,217 @@
+/**
+ * Identity-engine SDK contracts.
+ *
+ * Connectors emit `ConnectorFact[]` for the authenticated subject; catalog
+ * YAMLs declare `AutoCreateWhenRule[]` on relationship types; the engine
+ * matches facts against rules and writes derivations.
+ *
+ * Schemas are TypeBox so they double as runtime validators at every write
+ * boundary (seeder, engine, MCP tools). Validation is mandatory — the
+ * collapsed model puts a lot in `metadata jsonb`, so without validation the
+ * engine silently corrupts on malformed input.
+ */
+import { Type } from '@sinclair/typebox';
+// =============================================================================
+// Assurance levels
+// =============================================================================
+/**
+ * How strongly the connector vouches for a fact. Rules require a minimum
+ * assurance to fire. The order is total: `oauth_verified_admin_role` >
+ * `oauth_verified` > `cookie_session` > `self_attested`.
+ */
+export const AssuranceLevel = Type.Union([
+    Type.Literal('oauth_verified_admin_role'),
+    Type.Literal('oauth_verified'),
+    Type.Literal('cookie_session'),
+    Type.Literal('self_attested'),
+], { $id: 'AssuranceLevel' });
+const ASSURANCE_RANK = {
+    oauth_verified_admin_role: 4,
+    oauth_verified: 3,
+    cookie_session: 2,
+    self_attested: 1,
+};
+export function assuranceMeets(actual, required) {
+    return ASSURANCE_RANK[actual] >= ASSURANCE_RANK[required];
+}
+// =============================================================================
+// ConnectorFact — what a connector emits
+// =============================================================================
+export const ConnectorFact = Type.Object({
+    /** The attribute kind. Each connector declares which namespaces it produces. */
+    namespace: Type.String({ minLength: 1, maxLength: 64 }),
+    /** Raw value as the provider returned it. Audit-friendly. */
+    identifier: Type.String({ minLength: 1, maxLength: 1024 }),
+    /**
+     * Canonicalised form used for index lookups. Connectors run normalize* on
+     * the value before emitting; the engine re-normalises defensively.
+     */
+    normalizedValue: Type.String({ minLength: 1, maxLength: 1024 }),
+    /** How the connector verified this fact. */
+    assurance: AssuranceLevel,
+    /**
+     * Provider's immutable account identifier — the primary binding key
+     * that survives email changes and account-row reissues.
+     */
+    providerStableId: Type.String({ minLength: 1, maxLength: 256 }),
+    /**
+     * Which connector account row produced this fact. Lets the engine diff
+     * facts per session for revocation.
+     */
+    sourceAccountId: Type.String({ minLength: 1, maxLength: 256 }),
+    /** ISO-8601 timestamp. Optional; required for high-assurance facts in production. */
+    validTo: Type.Optional(Type.String({ minLength: 1, maxLength: 64 })),
+    /**
+     * Optional human-readable note about trust caveats this fact carries.
+     * Surfaced in audit logs and admin UIs; never used by the engine.
+     */
+    notes: Type.Optional(Type.String({ maxLength: 512 })),
+}, { $id: 'ConnectorFact', additionalProperties: false });
+// =============================================================================
+// ConnectorIdentityCapability — what a connector promises to emit
+// =============================================================================
+/**
+ * Each connector exports a static capability declaration. CI lints that the
+ * namespaces it actually emits at runtime are a subset of `produces`.
+ */
+export const ConnectorIdentityCapability = Type.Object({
+    connectorKey: Type.String({ minLength: 1, maxLength: 64 }),
+    produces: Type.Array(Type.Object({
+        namespace: Type.String({ minLength: 1, maxLength: 64 }),
+        assurance: AssuranceLevel,
+        notes: Type.Optional(Type.String({ maxLength: 512 })),
+    }), { minItems: 0, maxItems: 32 }),
+}, { $id: 'ConnectorIdentityCapability', additionalProperties: false });
+// =============================================================================
+// AutoCreateWhenRule — declared on relationship-type YAMLs, compiled into
+// entity_relationship_types.metadata.auto_create_when[]
+// =============================================================================
+/**
+ * `unique_only` rejects ambiguity (writes a collision event for admin
+ * resolution); `all_matches` fans out to every match and is only safe for
+ * weak relationships. `first_match` is deliberately excluded — silently
+ * picking a winner on collision would open adoption-takeover paths.
+ */
+export const MatchStrategy = Type.Union([Type.Literal('unique_only'), Type.Literal('all_matches')], { $id: 'MatchStrategy' });
+export const AutoCreateWhenRule = Type.Object({
+    /** The fact namespace this rule listens for. */
+    sourceNamespace: Type.String({ minLength: 1, maxLength: 64 }),
+    /**
+     * The metadata field on the target entity-type whose normalized value
+     * must equal the fact's normalizedValue.
+     */
+    targetField: Type.String({ minLength: 1, maxLength: 64 }),
+    /**
+     * Minimum assurance the fact must carry to fire this rule. The engine
+     * enforces `assuranceMeets(fact.assurance, rule.assuranceRequired)`.
+     */
+    assuranceRequired: AssuranceLevel,
+    matchStrategy: MatchStrategy,
+    /**
+     * Optional notes for review tooling — not consumed by the engine.
+     */
+    notes: Type.Optional(Type.String({ maxLength: 512 })),
+}, { $id: 'AutoCreateWhenRule', additionalProperties: false });
+/**
+ * The shape stored on `entity_relationship_types.metadata`. Includes the
+ * declared rules plus a version+hash so derivations can pin to the rule
+ * version that fired them and reconciliation can detect drift.
+ */
+export const RelationshipTypeIdentityMetadata = Type.Object({
+    autoCreateWhen: Type.Array(AutoCreateWhenRule, { maxItems: 16 }),
+    /** Monotonically increasing per relationship-type. Bumped by the seeder on every YAML change. */
+    ruleVersion: Type.Integer({ minimum: 1 }),
+    /** sha256 of the canonicalised auto_create_when array. Drift detection. */
+    ruleHash: Type.String({ minLength: 64, maxLength: 64 }),
+}, { $id: 'RelationshipTypeIdentityMetadata', additionalProperties: true });
+// =============================================================================
+// Fact event metadata — written into events.metadata when the engine
+// persists a connector fact as `semantic_type='identity_fact'`
+// =============================================================================
+/**
+ * Stored on `events.metadata` for `semantic_type='identity_fact'` rows.
+ *
+ * Tombstone facts (written when a connector refresh stops emitting a
+ * namespace) carry empty `identifier`/`normalizedValue`/`providerStableId`,
+ * which is why those fields allow empty strings here even though
+ * `ConnectorFact` (the connector-side input) requires non-empty.
+ */
+export const FactEventMetadata = Type.Object({
+    namespace: Type.String({ minLength: 1, maxLength: 64 }),
+    identifier: Type.String({ minLength: 0, maxLength: 1024 }),
+    normalizedValue: Type.String({ minLength: 0, maxLength: 1024 }),
+    assurance: AssuranceLevel,
+    providerStableId: Type.String({ minLength: 0, maxLength: 256 }),
+    sourceAccountId: Type.String({ minLength: 1, maxLength: 256 }),
+    /** ISO-8601 timestamp string. Optional; required for high-assurance facts in production. */
+    validTo: Type.Optional(Type.String({ minLength: 1, maxLength: 64 })),
+    notes: Type.Optional(Type.String({ maxLength: 512 })),
+}, { $id: 'FactEventMetadata', additionalProperties: false });
+// =============================================================================
+// DerivedFromProvenance — written into entity_relationships.metadata when
+// the engine auto-creates a relationship
+// =============================================================================
+export const DerivedFromProvenance = Type.Object({
+    /** events.id of the fact that produced this derivation. */
+    sourceEventId: Type.Integer({ minimum: 1 }),
+    /** Which relationship-type rule fired (entity_relationship_types.id). */
+    relationshipTypeId: Type.Integer({ minimum: 1 }),
+    /** Snapshot of the rule version that fired. Drift signal for reconcile. */
+    ruleVersion: Type.Integer({ minimum: 1 }),
+    /** Hash matching ruleHash on the relationship-type at fire time. */
+    ruleHash: Type.String({ minLength: 64, maxLength: 64 }),
+    /** Echoed for fast assurance audits without joining back to the event. */
+    factAssurance: AssuranceLevel,
+    /** ISO-8601 timestamp. Echoes events.created_at; convenience for relationship-only audits. */
+    derivedAt: Type.String({ minLength: 1, maxLength: 64 }),
+}, { $id: 'DerivedFromProvenance', additionalProperties: false });
+/**
+ * The metadata blob stored on entity_relationships.metadata for derived
+ * rows. Closed shape — extra keys are rejected so the engine can never
+ * accidentally land junk alongside the provenance.
+ */
+export const DerivedRelationshipMetadata = Type.Object({
+    derivedFrom: DerivedFromProvenance,
+}, { $id: 'DerivedRelationshipMetadata', additionalProperties: false });
+// =============================================================================
+// ClaimCollision — pending-approval event payload
+// =============================================================================
+/**
+ * When a fact match would adopt a `$member` row that's already bound to a
+ * different user (or vice versa), the engine writes a pending-approval event
+ * with this shape. Resolution = a privileged user flips
+ * `interaction_status='approved'` after merging entities, or 'rejected' to
+ * dismiss without action.
+ */
+export const ClaimCollisionPayload = Type.Object({
+    kind: Type.Literal('identity_match'),
+    namespace: Type.String({ minLength: 1, maxLength: 64 }),
+    identifier: Type.String({ minLength: 1, maxLength: 1024 }),
+    normalizedValue: Type.String({ minLength: 1, maxLength: 1024 }),
+    /**
+     * Catalog entity ids that all match this fact's normalized value.
+     * Despite the historical name suggesting `$member`, these are general
+     * catalog entities (founders, companies, etc.) — the resolver picks
+     * which one the user intends to claim.
+     */
+    candidateEntityIds: Type.Array(Type.Integer({ minimum: 1 }), {
+        minItems: 2,
+        maxItems: 16,
+    }),
+    /** Total number of matching candidates; candidateEntityIds may be capped for UI payload size. */
+    candidateCount: Type.Optional(Type.Integer({ minimum: 2 })),
+    /**
+     * Which fact (events.id) raised the collision. Lets the resolver replay
+     * the binding once the human picks a winner.
+     */
+    triggeringEventId: Type.Integer({ minimum: 1 }),
+    /** Rule that would have fired if the match were unambiguous. */
+    relationshipTypeId: Type.Optional(Type.Integer({ minimum: 1 })),
+}, { $id: 'ClaimCollisionPayload', additionalProperties: false });
+// =============================================================================
+// Constants — used by core code AND connector tests so the lint check has
+// a single source of truth.
+// =============================================================================
+export const IDENTITY_FACT_SEMANTIC_TYPE = 'identity_fact';
+export const CLAIM_COLLISION_SEMANTIC_TYPE = 'claim_collision';
+//# sourceMappingURL=identity-types.js.map

package/dist/identity-types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+export type { Static } from '@sinclair/typebox';
+export { Type } from '@sinclair/typebox';
+export type { KyInstance, Options } from 'ky';
+export { default as ky, HTTPError } from 'ky';
+export { ConnectorRuntime } from './connector-runtime.js';
+export type { ActionContext, ActionDefinition, ActionResult, ApprovalStatus, AuthArtifact, AuthContext, AuthResult, Connection, ConnectorAuthBrowser, ConnectorAuthEnvField, ConnectorAuthEnvKeys, ConnectorAuthInteractive, ConnectorAuthMethod, ConnectorAuthNone, ConnectorAuthOAuth, ConnectorAuthSchema, ConnectorDefinition, ContentItem, EntityIdentitySpec, EntityLinkOverride, EntityLinkOverrides, EntityLinkRule, EntityTraitSpec, EventEnvelope, Feed, FeedDefinition, FeedMode, IdentityNamespace, Run, RunStatus, RunType, SyncContext, SyncCredentials, SyncResult, } from './connector-types.js';
+export { IDENTITY } from './connector-types.js';
+export { AssuranceLevel, assuranceMeets, AutoCreateWhenRule, CLAIM_COLLISION_SEMANTIC_TYPE, ClaimCollisionPayload, ConnectorFact, ConnectorIdentityCapability, DerivedFromProvenance, DerivedRelationshipMetadata, FactEventMetadata, IDENTITY_FACT_SEMANTIC_TYPE, MatchStrategy, RelationshipTypeIdentityMetadata, } from './identity-types.js';
+export { isSourceNativeEventType, SOURCE_NATIVE_EVENT_TYPES } from './event-taxonomy.js';
+export { createAuthenticatedClient, createHttpClient, httpClient, jsonHttpClient, } from './http.js';
+export { normalizeAuthUserId, normalizeEmail, normalizeGithubLogin, normalizeGoogleContactId, normalizeIdentifier, normalizePhone, normalizeSlackUserId, normalizeWaJid, } from './identity-normalize.js';
+export { sdkLogger, sdkLogger as logger } from './logger.js';
+export { withHttpRetry } from './retry.js';
+export { calculateEngagementScore } from './scoring.js';
+export type { WatcherTimeGranularity } from './watcher-time.js';
+export { addWatcherPeriod, alignToWatcherWindowStart, getAvailableWatcherGranularities, getFinerWatcherGranularities, getNextWatcherGranularity, getWatcherDateTruncUnit, inferWatcherGranularityFromDays, inferWatcherGranularityFromSchedule, isWatcherTimeGranularity, shiftWatcherPeriod, subtractWatcherPeriod, WATCHER_TIME_GRANULARITIES, } from './watcher-time.js';
+export type { ApiSessionState } from './api-paginated.js';
+export { ApiPaginatedFeed } from './api-paginated.js';
+export { BaseFeed, RateLimitError } from './base.js';
+export type { AcquireBrowserOptions, AcquiredBrowser } from './browser/acquire.js';
+export { acquireBrowser, BrowserAuthCascadeError } from './browser/acquire.js';
+export type { CdpVersionInfo, ResolveCdpOptions } from './browser/cdp.js';
+export { discoverChromeListeningPorts, discoverChromeProcessCdpUrls, fetchCdpVersionInfo, normalizeCdpUrl, resolveCdpUrl, tryWebSocketCdp, } from './browser/cdp.js';
+export { CdpPage } from './browser/cdp-page.js';
+export type { BrowserLaunchOptions, EnhancedBrowser } from './browser/launcher.js';
+export { captureErrorArtifacts, launchBrowser, withErrorCapture, } from './browser/launcher.js';
+export type { StealthBrowser, StealthBrowserOptions } from './browser/stealth.js';
+export { getRandomDelay, humanWait, launchStealthBrowser, randomScroll, testBotDetection, } from './browser/stealth.js';
+export type { BrowserNetworkConfig, BrowserNetworkResult } from './browser-network.js';
+export { browserNetworkSync } from './browser-network.js';
+export type { BrowserFeedConfig, BrowserPaginationConfig, BrowserSessionState, CaptchaConfig, CookieConsentConfig, } from './browser-paginated.js';
+export { BrowserPaginatedFeed } from './browser-paginated.js';
+export type { PageFetchResult, PaginatedCheckpoint, PaginateResult, PaginationConfig, } from './paginated.js';
+export { PaginatedFeed } from './paginated.js';
+export type { ReactionContext, ReactionEntity } from './reaction-sdk.js';
+export type { Checkpoint, Content, Env, FeedAuthBrowserMethod, FeedAuthEnvField, FeedAuthEnvKeysMethod, FeedAuthMethod, FeedAuthNoneMethod, FeedAuthOAuthMethod, FeedAuthSchema, FeedOptions, FeedSyncResult, IFeed, ParentFeedDefinition, ScoringConfig, SearchResult, SessionState, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,33 @@
+// =============================================================================
+// V1 Integration Platform — Connector SDK
+// =============================================================================
+export { Type } from '@sinclair/typebox';
+export { default as ky, HTTPError } from 'ky';
+// Connector runtime & types (primary API)
+export { ConnectorRuntime } from './connector-runtime.js';
+export { IDENTITY } from './connector-types.js';
+// Identity-engine SDK contracts. Each schema export is both a TypeBox
+// runtime validator (value) AND a TypeScript type via declaration merging.
+export { AssuranceLevel, assuranceMeets, AutoCreateWhenRule, CLAIM_COLLISION_SEMANTIC_TYPE, ClaimCollisionPayload, ConnectorFact, ConnectorIdentityCapability, DerivedFromProvenance, DerivedRelationshipMetadata, FactEventMetadata, IDENTITY_FACT_SEMANTIC_TYPE, MatchStrategy, RelationshipTypeIdentityMetadata, } from './identity-types.js';
+export { isSourceNativeEventType, SOURCE_NATIVE_EVENT_TYPES } from './event-taxonomy.js';
+// HTTP clients
+export { createAuthenticatedClient, createHttpClient, httpClient, jsonHttpClient, } from './http.js';
+export { normalizeAuthUserId, normalizeEmail, normalizeGithubLogin, normalizeGoogleContactId, normalizeIdentifier, normalizePhone, normalizeSlackUserId, normalizeWaJid, } from './identity-normalize.js';
+// Logger
+export { sdkLogger, sdkLogger as logger } from './logger.js';
+// Retry
+export { withHttpRetry } from './retry.js';
+// Scoring
+export { calculateEngagementScore } from './scoring.js';
+export { addWatcherPeriod, alignToWatcherWindowStart, getAvailableWatcherGranularities, getFinerWatcherGranularities, getNextWatcherGranularity, getWatcherDateTruncUnit, inferWatcherGranularityFromDays, inferWatcherGranularityFromSchedule, isWatcherTimeGranularity, shiftWatcherPeriod, subtractWatcherPeriod, WATCHER_TIME_GRANULARITIES, } from './watcher-time.js';
+export { ApiPaginatedFeed } from './api-paginated.js';
+export { BaseFeed, RateLimitError } from './base.js';
+export { acquireBrowser, BrowserAuthCascadeError } from './browser/acquire.js';
+export { discoverChromeListeningPorts, discoverChromeProcessCdpUrls, fetchCdpVersionInfo, normalizeCdpUrl, resolveCdpUrl, tryWebSocketCdp, } from './browser/cdp.js';
+export { CdpPage } from './browser/cdp-page.js';
+export { captureErrorArtifacts, launchBrowser, withErrorCapture, } from './browser/launcher.js';
+export { getRandomDelay, humanWait, launchStealthBrowser, randomScroll, testBotDetection, } from './browser/stealth.js';
+export { browserNetworkSync } from './browser-network.js';
+export { BrowserPaginatedFeed } from './browser-paginated.js';
+export { PaginatedFeed } from './paginated.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,0CAA0C;AAC1C,gFAAgF;AAIhF,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAGzC,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC9C,0CAA0C;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAqC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,sEAAsE;AACtE,2EAA2E;AAC3E,OAAO,EACL,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,6BAA6B,EAC7B,qBAAqB,EACrB,aAAa,EACb,2BAA2B,EAC3B,qBAAqB,EACrB,2BAA2B,EAC3B,iBAAiB,EACjB,2BAA2B,EAC3B,aAAa,EACb,gCAAgC,GACjC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACzF,eAAe;AACf,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,UAAU,EACV,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,SAAS,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAC7D,QAAQ;AACR,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,UAAU;AACV,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,gCAAgC,EAChC,4BAA4B,EAC5B,yBAAyB,EACzB,uBAAuB,EACvB,+BAA+B,EAC/B,mCAAmC,EACnC,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAO3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,cAAc,EACd,SAAS,EACT,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAQ1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAO9D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,7 @@
+import pino from 'pino';
+/**
+ * SDK logger instance
+ * Uses its own pino instance, separate from the main app logger
+ */
+export declare const sdkLogger: pino.Logger<never, boolean>;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,SAAS,6BAGpB,CAAC"}

package/dist/logger.js

@@ -0,0 +1,10 @@
+import pino from 'pino';
+/**
+ * SDK logger instance
+ * Uses its own pino instance, separate from the main app logger
+ */
+export const sdkLogger = pino({
+    name: 'connector-sdk',
+    level: process.env.LOG_LEVEL || 'info',
+});
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;CACvC,CAAC,CAAC"}

package/dist/paginated.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Paginated Feed Base Class
+ *
+ * Provides a reusable pagination pattern for feeds that fetch data in pages.
+ * Uses the template method pattern - subclasses implement specific methods while
+ * the base class handles the pagination loop, rate limiting, and checkpoint management.
+ */
+import { BaseFeed } from './base.js';
+import type { Checkpoint, Content, Env, FeedOptions } from './types.js';
+/**
+ * Configuration for pagination behavior
+ */
+export interface PaginationConfig {
+    /** Maximum pages to fetch (safety limit). Default: 50 */
+    maxPages: number;
+    /** Expected items per page (for partial page detection). Default: 100 */
+    pageSize: number;
+    /** Milliseconds to wait between page requests. Default: 1000 */
+    rateLimitMs: number;
+    /** Whether to update checkpoint after each page (for resume). Default: false */
+    incrementalCheckpoint: boolean;
+}
+/**
+ * Result from fetching a single page
+ */
+export interface PageFetchResult<TItem> {
+    /** Items from this page */
+    items: TItem[];
+    /** Token/cursor for next page (null = no more pages) */
+    nextToken: string | null;
+    /** Optional: raw item count before any filtering (for logging) */
+    rawCount?: number;
+}
+/**
+ * Extended checkpoint interface with pagination token
+ */
+export interface PaginatedCheckpoint extends Checkpoint {
+    /** Pagination token for resuming sync */
+    pagination_token?: string | null;
+    /** Whether initial sync completed (used to choose checkpoint boundary) */
+    initial_complete?: boolean;
+}
+/**
+ * Result from the paginate() method
+ */
+export interface PaginateResult<TCheckpoint extends Checkpoint> {
+    contents: Content[];
+    checkpoint: TCheckpoint;
+    parentMap?: Map<string, string>;
+    nextSyncRecommendedAt?: Date;
+}
+/**
+ * Base class for feeds with cursor/page-based pagination
+ */
+export declare abstract class PaginatedFeed<TItem, TCheckpoint extends PaginatedCheckpoint = PaginatedCheckpoint> extends BaseFeed {
+    /**
+     * Default pagination configuration
+     */
+    protected getPaginationConfig(): PaginationConfig;
+    /**
+     * ABSTRACT: Fetch a single page of items from the platform
+     */
+    protected abstract fetchPage(cursor: string | null, options: FeedOptions, env: Env): Promise<PageFetchResult<TItem>>;
+    /**
+     * ABSTRACT: Transform a platform item to Content format
+     */
+    protected abstract transformItem(item: TItem, options: FeedOptions): Content;
+    /**
+     * ABSTRACT: Extract published date from platform item
+     */
+    protected abstract getItemDate(item: TItem): Date;
+    /**
+     * OPTIONAL: Filter items before transformation
+     */
+    protected filterItem(_item: TItem, _options: FeedOptions): boolean;
+    /**
+     * OPTIONAL: Extract parent ID for hierarchical content
+     */
+    protected getParentId(_item: TItem): string | null;
+    /**
+     * OPTIONAL: Extract pagination token from checkpoint
+     */
+    protected getPaginationToken(checkpoint: TCheckpoint | null): string | null;
+    /**
+     * OPTIONAL: Create checkpoint with feed-specific fields
+     */
+    protected createCheckpoint(existing: TCheckpoint | null, latestContent: Content | null, nextToken: string | null, itemsProcessed: number): TCheckpoint;
+    /**
+     * Main pagination loop - handles both initial and incremental syncs
+     */
+    protected paginate(options: FeedOptions, checkpoint: TCheckpoint | null, env: Env, updateCheckpointFn?: (checkpoint: Checkpoint) => Promise<void>): Promise<PaginateResult<TCheckpoint>>;
+}
+//# sourceMappingURL=paginated.d.ts.map

package/dist/paginated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginated.d.ts","sourceRoot":"","sources":["../src/paginated.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAkB,MAAM,WAAW,CAAC;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,KAAK;IACpC,2BAA2B;IAC3B,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,wDAAwD;IACxD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,WAAW,SAAS,UAAU;IAC5D,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,UAAU,EAAE,WAAW,CAAC;IACxB,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,qBAAqB,CAAC,EAAE,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,8BAAsB,aAAa,CACjC,KAAK,EACL,WAAW,SAAS,mBAAmB,GAAG,mBAAmB,CAC7D,SAAQ,QAAQ;IAChB;;OAEG;IACH,SAAS,CAAC,mBAAmB,IAAI,gBAAgB;IASjD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,CAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAElC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO;IAE5E;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAEjD;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO;IAIlE;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI;IAIlD;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI;IAI3E;;OAEG;IACH,SAAS,CAAC,gBAAgB,CACxB,QAAQ,EAAE,WAAW,GAAG,IAAI,EAC5B,aAAa,EAAE,OAAO,GAAG,IAAI,EAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,cAAc,EAAE,MAAM,GACrB,WAAW;IAUd;;OAEG;cACa,QAAQ,CACtB,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,WAAW,GAAG,IAAI,EAC9B,GAAG,EAAE,GAAG,EACR,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAC7D,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;CA6JxC"}

package/dist/paginated.js

@@ -0,0 +1,167 @@
+/**
+ * Paginated Feed Base Class
+ *
+ * Provides a reusable pagination pattern for feeds that fetch data in pages.
+ * Uses the template method pattern - subclasses implement specific methods while
+ * the base class handles the pagination loop, rate limiting, and checkpoint management.
+ */
+import { BaseFeed, RateLimitError } from './base.js';
+import { sdkLogger } from './logger.js';
+/**
+ * Base class for feeds with cursor/page-based pagination
+ */
+export class PaginatedFeed extends BaseFeed {
+    /**
+     * Default pagination configuration
+     */
+    getPaginationConfig() {
+        return {
+            maxPages: 50,
+            pageSize: 100,
+            rateLimitMs: 1000,
+            incrementalCheckpoint: false,
+        };
+    }
+    /**
+     * OPTIONAL: Filter items before transformation
+     */
+    filterItem(_item, _options) {
+        return true;
+    }
+    /**
+     * OPTIONAL: Extract parent ID for hierarchical content
+     */
+    getParentId(_item) {
+        return null;
+    }
+    /**
+     * OPTIONAL: Extract pagination token from checkpoint
+     */
+    getPaginationToken(checkpoint) {
+        return checkpoint?.pagination_token ?? null;
+    }
+    /**
+     * OPTIONAL: Create checkpoint with feed-specific fields
+     */
+    createCheckpoint(existing, latestContent, nextToken, itemsProcessed) {
+        return {
+            updated_at: new Date(),
+            last_timestamp: latestContent?.occurred_at ?? existing?.last_timestamp,
+            pagination_token: nextToken,
+            total_items_processed: (existing?.total_items_processed || 0) + itemsProcessed,
+            initial_complete: existing?.initial_complete ?? false,
+        };
+    }
+    /**
+     * Main pagination loop - handles both initial and incremental syncs
+     */
+    async paginate(options, checkpoint, env, updateCheckpointFn) {
+        const config = this.getPaginationConfig();
+        const existingToken = this.getPaginationToken(checkpoint);
+        const parentMap = new Map();
+        const initialComplete = checkpoint?.initial_complete ?? (!!checkpoint?.last_timestamp && !existingToken);
+        const isIncremental = initialComplete && !existingToken;
+        const lookbackDate = this.getLookbackDate(options);
+        const checkpointTimestamp = checkpoint?.last_timestamp ?? null;
+        const checkpointDate = checkpointTimestamp
+            ? checkpointTimestamp instanceof Date
+                ? checkpointTimestamp
+                : new Date(checkpointTimestamp)
+            : null;
+        const boundaryDate = initialComplete && checkpointDate ? checkpointDate : lookbackDate;
+        const allContents = [];
+        let cursor = isIncremental ? null : existingToken;
+        let pageCount = 0;
+        let stopReason = null;
+        let rateLimitRetryMs;
+        const modeLabel = isIncremental ? 'incremental' : cursor ? 'resumed' : 'initial';
+        sdkLogger.info(`[${this.type}] Starting ${modeLabel} sync (max ${config.maxPages} pages)`);
+        while (pageCount < config.maxPages) {
+            if (pageCount > 0) {
+                await this.sleep(config.rateLimitMs);
+            }
+            let result;
+            try {
+                result = await this.fetchPage(cursor, options, env);
+            }
+            catch (error) {
+                if (error instanceof RateLimitError) {
+                    sdkLogger.warn({ error: error.message }, `[${this.type}] Rate limit hit after ${pageCount} pages, pausing`);
+                    stopReason = 'rate_limited';
+                    rateLimitRetryMs = error.retryAfterMs;
+                    break;
+                }
+                throw error;
+            }
+            const rawCount = result.rawCount ?? result.items.length;
+            if (result.items.length === 0) {
+                sdkLogger.info(`[${this.type}] Empty page at ${pageCount + 1}, stopping`);
+                stopReason = 'empty_page';
+                break;
+            }
+            const pageContents = [];
+            for (const item of result.items) {
+                if (!this.filterItem(item, options))
+                    continue;
+                const content = this.transformItem(item, options);
+                pageContents.push(content);
+                const parentId = this.getParentId(item);
+                if (parentId) {
+                    parentMap.set(content.origin_id, parentId);
+                    if (!content.origin_parent_id) {
+                        content.origin_parent_id = parentId;
+                    }
+                }
+            }
+            const boundaryContents = pageContents.filter((c) => c.occurred_at >= boundaryDate);
+            allContents.push(...boundaryContents);
+            pageCount++;
+            sdkLogger.info(`[${this.type}] Page ${pageCount}: raw=${rawCount}, ` +
+                `filtered=${pageContents.length}, recent=${boundaryContents.length}, ` +
+                `nextToken=${result.nextToken ? 'yes' : 'no'}`);
+            if (config.incrementalCheckpoint && updateCheckpointFn && allContents.length > 0) {
+                const incrementalCP = this.createCheckpoint(checkpoint, allContents[0], result.nextToken, boundaryContents.length);
+                await updateCheckpointFn(incrementalCP);
+                sdkLogger.debug(`[${this.type}] Saved incremental checkpoint after page ${pageCount}`);
+            }
+            if (boundaryContents.length === 0 && pageContents.length > 0) {
+                sdkLogger.info(`[${this.type}] Reached boundary after ${pageCount} pages`);
+                stopReason = 'boundary';
+                break;
+            }
+            if (result.items.length < config.pageSize) {
+                sdkLogger.info(`[${this.type}] Partial page (${result.items.length}/${config.pageSize}), end reached`);
+                stopReason = 'partial_page';
+                break;
+            }
+            if (!result.nextToken) {
+                sdkLogger.info(`[${this.type}] No next token after page ${pageCount}, end reached`);
+                stopReason = 'no_next_token';
+                break;
+            }
+            cursor = result.nextToken;
+        }
+        if (!stopReason && pageCount >= config.maxPages) {
+            stopReason = 'max_pages';
+        }
+        if (stopReason === 'max_pages') {
+            sdkLogger.warn(`[${this.type}] Hit max page limit (${config.maxPages})`);
+        }
+        sdkLogger.info(`[${this.type}] Pagination complete: ${allContents.length} items from ${pageCount} pages`);
+        const resumeToken = stopReason === 'max_pages' || stopReason === 'rate_limited' ? cursor : null;
+        const shouldMarkComplete = initialComplete ||
+            (!initialComplete && stopReason !== 'max_pages' && stopReason !== 'rate_limited');
+        const nextSyncRecommendedAt = stopReason === 'rate_limited'
+            ? new Date(Date.now() + (rateLimitRetryMs ?? config.rateLimitMs))
+            : undefined;
+        const finalCheckpoint = this.createCheckpoint(checkpoint, allContents[0] || null, resumeToken, allContents.length);
+        finalCheckpoint.initial_complete = shouldMarkComplete;
+        return {
+            contents: allContents,
+            checkpoint: finalCheckpoint,
+            parentMap: parentMap.size > 0 ? parentMap : undefined,
+            nextSyncRecommendedAt,
+        };
+    }
+}
+//# sourceMappingURL=paginated.js.map

package/dist/paginated.js.map

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