@atproto/bsky 0.2.2 → 0.3.1

package/dist/feature-gates/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/feature-gates/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { GrowthBookClient } from '@growthbook/growthbook'\nimport type express from 'express'\nimport { featureGatesLogger } from '../logger.js'\nimport { Gate, IGNORE_METRICS_FOR_GATES } from './gates.js'\nimport { MetricsClient } from './metrics.js'\nimport type {\n  CheckedFeatureGatesMap,\n  ScopedFeatureGatesClient,\n  UserContext,\n} from './types.js'\nimport {\n  extractUserContextFromGrowthbookUserContext,\n  mergeUserContexts,\n  normalizeUserContext,\n  parsedUserContextToTrackingMetadata,\n} from './utils.js'\n\n/**\n * We want this to be sufficiently high that we don't time out under\n * normal conditions, but not so high that it takes too long to boot\n * the server.\n */\nconst FETCH_TIMEOUT = 3e3 // 3 seconds\n\n/**\n * StatSig used to default to every 10s, but I think 1m is fine\n */\nconst REFETCH_INTERVAL = 60e3 // 1 minute\n\n/**\n * These need to match what the client sends\n */\nconst ANALYTICS_HEADER_DEVICE_ID = 'x-atproto-device-id'\nconst ANALYTICS_HEADER_SESSION_ID = 'x-atproto-session-id'\n\nexport { type ScopedFeatureGatesClient } from './types.js'\n\nexport class FeatureGatesClient {\n  private ready = false\n  private client: GrowthBookClient | undefined = undefined\n  private refreshInterval: NodeJS.Timeout | undefined = undefined\n  private metrics: MetricsClient\n\n  /**\n   * Easy access to the `Gate` enum for consumers of this class, so they don't\n   * need to import it separately.\n   */\n  Gate = Gate\n\n  constructor(\n    private config: {\n      growthBookApiHost?: string\n      growthBookClientKey?: string\n      eventProxyTrackingEndpoint?: string\n    },\n  ) {\n    this.metrics = new MetricsClient({\n      trackingEndpoint: config.eventProxyTrackingEndpoint,\n    })\n  }\n\n  async start() {\n    if (!this.config.growthBookApiHost || !this.config.growthBookClientKey) {\n      featureGatesLogger.info(\n        {},\n        'feature gates not configured, skipping initialization',\n      )\n      return\n    }\n\n    try {\n      this.client = new GrowthBookClient({\n        apiHost: this.config.growthBookApiHost,\n        clientKey: this.config.growthBookClientKey,\n        onFeatureUsage: async (feature, result, userContext) => {\n          if (IGNORE_METRICS_FOR_GATES.has(feature as Gate)) return\n\n          await this.metrics.track(\n            'feature:viewed',\n            {\n              featureId: feature,\n              featureResultValue: result.value,\n              experimentId: result.experiment?.key,\n              variationId: result.experimentResult?.key,\n            },\n            parsedUserContextToTrackingMetadata(\n              extractUserContextFromGrowthbookUserContext(userContext),\n            ),\n          )\n        },\n        trackingCallback: async (experiment, result, userContext) => {\n          /**\n           * Experiments are only fired in a feature gate has an Experiment\n           * attached in Growthbook. Howerver, we want to be extra sure that a\n           * misconfigured experiment doesn't result in a huge increase in events, so we\n           * protect this here.\n           */\n          if (\n            result.featureId &&\n            IGNORE_METRICS_FOR_GATES.has(result.featureId as Gate)\n          )\n            return\n\n          await this.metrics.track(\n            'experiment:viewed',\n            {\n              experimentId: experiment.key,\n              variationId: result.key,\n            },\n            parsedUserContextToTrackingMetadata(\n              extractUserContextFromGrowthbookUserContext(userContext),\n            ),\n          )\n        },\n      })\n\n      const { source, error } = await this.client.init({\n        timeout: FETCH_TIMEOUT,\n      })\n\n      /**\n       * This does not necessarily mean that the client completely failed,\n       * since it could just be that the request timed out. It may succeed\n       * after the timeout, or later during refreshes.\n       *\n       * @see https://docs.growthbook.io/lib/node#error-handling\n       */\n      if (error) {\n        featureGatesLogger.error(\n          { err: error, source },\n          'Client failed to initialize normally',\n        )\n      }\n\n      /**\n       * Set up periodic refresh of feature definitions\n       *\n       * @see https://docs.growthbook.io/lib/node#refreshing-features\n       */\n      this.refreshInterval = setInterval(async () => {\n        try {\n          await this.client?.refreshFeatures({\n            timeout: FETCH_TIMEOUT,\n          })\n        } catch (err) {\n          featureGatesLogger.error({ err }, 'Failed to refresh features')\n        }\n      }, REFETCH_INTERVAL)\n\n      /* Ready or not, here we come */\n      this.ready = true\n    } catch (err) {\n      featureGatesLogger.error({ err }, 'Client initialization failed')\n    }\n  }\n\n  async destroy() {\n    if (this.ready) {\n      this.ready = false\n      if (this.refreshInterval) {\n        clearInterval(this.refreshInterval)\n      }\n    }\n    await this.metrics.stop()\n  }\n\n  async [Symbol.asyncDispose]() {\n    await this.destroy()\n  }\n\n  /**\n   * Evaluate multiple feature gates for a given user, returning a map of gate\n   * ID to boolean result.\n   */\n  private checkGates(\n    gates: Gate[],\n    userContext: UserContext,\n  ): CheckedFeatureGatesMap {\n    const gb = this.client\n    const attributes = normalizeUserContext(userContext)\n    if (!gb || !this.ready) return new Map(gates.map((g) => [g, false]))\n    return new Map(gates.map((g) => [g, gb.isOn(g, { attributes })]))\n  }\n\n  scope(scopedUserContext: UserContext): ScopedFeatureGatesClient {\n    /*\n     * Create initial deviceId and sessionId values for the scoped client, to\n     * be used throughout this request lifecycle.\n     */\n    const base = normalizeUserContext(scopedUserContext)\n    return {\n      Gate: this.Gate,\n      checkGates: (\n        gates: Gate[],\n        userContextOverrides?: Pick<UserContext, 'did'>,\n      ) => {\n        const userContext = mergeUserContexts(base, userContextOverrides)\n        return this.checkGates(gates, userContext)\n      },\n      checkGate: (gate: Gate, userContextOverrides?: UserContext) => {\n        const userContext = mergeUserContexts(base, userContextOverrides)\n        return this.checkGates([gate], userContext).get(gate) || false\n      },\n    }\n  }\n\n  /**\n   * Parse properties available in XRPC handlers to `UserContext`. The returned\n   * proeprties are used as GrowthBook `attributes` as well as the metadata\n   * payload for our analytics events. This ensures that the same user properties\n   * are used for both feature gate targeting and analytics.\n   */\n  parseUserContextFromHandler({\n    viewer,\n    req,\n  }: {\n    /**\n     * The user's DID\n     */\n    viewer: string | null\n    /**\n     * The express request object, used to extract analytics headers for the user context\n     */\n    req: express.Request\n  }): UserContext {\n    const deviceId = req.header(ANALYTICS_HEADER_DEVICE_ID)\n    const sessionId = req.header(ANALYTICS_HEADER_SESSION_ID)\n\n    return normalizeUserContext({\n      did: viewer,\n      deviceId,\n      sessionId,\n    })\n  }\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/feature-gates/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { GrowthBookClient } from '@growthbook/growthbook'\nimport type express from 'express'\nimport { featureGatesLogger } from '../logger.js'\nimport { Gate, IGNORE_METRICS_FOR_GATES } from './gates.js'\nimport { MetricsClient } from './metrics.js'\nimport type {\n  CheckedFeatureGatesMap,\n  ScopedFeatureGatesClient,\n  UserContext,\n} from './types.js'\nimport {\n  extractUserContextFromGrowthbookUserContext,\n  mergeUserContexts,\n  normalizeUserContext,\n  parsedUserContextToTrackingMetadata,\n} from './utils.js'\n\n/**\n * We want this to be sufficiently high that we don't time out under\n * normal conditions, but not so high that it takes too long to boot\n * the server.\n */\nconst FETCH_TIMEOUT = 3e3 // 3 seconds\n\n/**\n * StatSig used to default to every 10s, but I think 1m is fine\n */\nconst REFETCH_INTERVAL = 60e3 // 1 minute\n\n/**\n * These need to match what the client sends\n */\nexport const ANALYTICS_HEADER_DEVICE_ID = 'x-atproto-device-id'\nexport const ANALYTICS_HEADER_SESSION_ID = 'x-atproto-session-id'\n\nexport { type ScopedFeatureGatesClient } from './types.js'\n\nexport class FeatureGatesClient {\n  private ready = false\n  private client: GrowthBookClient | undefined = undefined\n  private refreshInterval: NodeJS.Timeout | undefined = undefined\n  private metrics: MetricsClient\n\n  /**\n   * Easy access to the `Gate` enum for consumers of this class, so they don't\n   * need to import it separately.\n   */\n  Gate = Gate\n\n  constructor(\n    private config: {\n      growthBookApiHost?: string\n      growthBookClientKey?: string\n      eventProxyTrackingEndpoint?: string\n    },\n  ) {\n    this.metrics = new MetricsClient({\n      trackingEndpoint: config.eventProxyTrackingEndpoint,\n    })\n  }\n\n  async start() {\n    if (!this.config.growthBookApiHost || !this.config.growthBookClientKey) {\n      featureGatesLogger.info(\n        {},\n        'feature gates not configured, skipping initialization',\n      )\n      return\n    }\n\n    try {\n      this.client = new GrowthBookClient({\n        apiHost: this.config.growthBookApiHost,\n        clientKey: this.config.growthBookClientKey,\n        onFeatureUsage: async (feature, result, userContext) => {\n          if (IGNORE_METRICS_FOR_GATES.has(feature as Gate)) return\n\n          await this.metrics.track(\n            'feature:viewed',\n            {\n              featureId: feature,\n              featureResultValue: result.value,\n              experimentId: result.experiment?.key,\n              variationId: result.experimentResult?.key,\n            },\n            parsedUserContextToTrackingMetadata(\n              extractUserContextFromGrowthbookUserContext(userContext),\n            ),\n          )\n        },\n        trackingCallback: async (experiment, result, userContext) => {\n          /**\n           * Experiments are only fired in a feature gate has an Experiment\n           * attached in Growthbook. Howerver, we want to be extra sure that a\n           * misconfigured experiment doesn't result in a huge increase in events, so we\n           * protect this here.\n           */\n          if (\n            result.featureId &&\n            IGNORE_METRICS_FOR_GATES.has(result.featureId as Gate)\n          )\n            return\n\n          await this.metrics.track(\n            'experiment:viewed',\n            {\n              experimentId: experiment.key,\n              variationId: result.key,\n            },\n            parsedUserContextToTrackingMetadata(\n              extractUserContextFromGrowthbookUserContext(userContext),\n            ),\n          )\n        },\n      })\n\n      const { source, error } = await this.client.init({\n        timeout: FETCH_TIMEOUT,\n      })\n\n      /**\n       * This does not necessarily mean that the client completely failed,\n       * since it could just be that the request timed out. It may succeed\n       * after the timeout, or later during refreshes.\n       *\n       * @see https://docs.growthbook.io/lib/node#error-handling\n       */\n      if (error) {\n        featureGatesLogger.error(\n          { err: error, source },\n          'Client failed to initialize normally',\n        )\n      }\n\n      /**\n       * Set up periodic refresh of feature definitions\n       *\n       * @see https://docs.growthbook.io/lib/node#refreshing-features\n       */\n      this.refreshInterval = setInterval(async () => {\n        try {\n          await this.client?.refreshFeatures({\n            timeout: FETCH_TIMEOUT,\n          })\n        } catch (err) {\n          featureGatesLogger.error({ err }, 'Failed to refresh features')\n        }\n      }, REFETCH_INTERVAL)\n\n      /* Ready or not, here we come */\n      this.ready = true\n    } catch (err) {\n      featureGatesLogger.error({ err }, 'Client initialization failed')\n    }\n  }\n\n  async destroy() {\n    if (this.ready) {\n      this.ready = false\n      if (this.refreshInterval) {\n        clearInterval(this.refreshInterval)\n      }\n    }\n    await this.metrics.stop()\n  }\n\n  async [Symbol.asyncDispose]() {\n    await this.destroy()\n  }\n\n  /**\n   * Evaluate multiple feature gates for a given user, returning a map of gate\n   * ID to boolean result.\n   */\n  private checkGates(\n    gates: Gate[],\n    userContext: UserContext,\n  ): CheckedFeatureGatesMap {\n    const gb = this.client\n    const attributes = normalizeUserContext(userContext)\n    if (!gb || !this.ready) return new Map(gates.map((g) => [g, false]))\n    return new Map(gates.map((g) => [g, gb.isOn(g, { attributes })]))\n  }\n\n  scope(scopedUserContext: UserContext): ScopedFeatureGatesClient {\n    /*\n     * Create initial deviceId and sessionId values for the scoped client, to\n     * be used throughout this request lifecycle.\n     */\n    const base = normalizeUserContext(scopedUserContext)\n    return {\n      Gate: this.Gate,\n      checkGates: (\n        gates: Gate[],\n        userContextOverrides?: Pick<UserContext, 'did'>,\n      ) => {\n        const userContext = mergeUserContexts(base, userContextOverrides)\n        return this.checkGates(gates, userContext)\n      },\n      checkGate: (gate: Gate, userContextOverrides?: UserContext) => {\n        const userContext = mergeUserContexts(base, userContextOverrides)\n        return this.checkGates([gate], userContext).get(gate) || false\n      },\n    }\n  }\n\n  /**\n   * Parse properties available in XRPC handlers to `UserContext`. The returned\n   * proeprties are used as GrowthBook `attributes` as well as the metadata\n   * payload for our analytics events. This ensures that the same user properties\n   * are used for both feature gate targeting and analytics.\n   */\n  parseUserContextFromHandler({\n    viewer,\n    req,\n  }: {\n    /**\n     * The user's DID\n     */\n    viewer: string | null\n    /**\n     * The express request object, used to extract analytics headers for the user context\n     */\n    req: express.Request\n  }): UserContext {\n    const deviceId = req.header(ANALYTICS_HEADER_DEVICE_ID)\n    const sessionId = req.header(ANALYTICS_HEADER_SESSION_ID)\n\n    return normalizeUserContext({\n      did: viewer,\n      deviceId,\n      sessionId,\n    })\n  }\n}\n"]}

package/dist/hydration/external.d.ts

@@ -1,6 +1,6 @@
 import { type AtUriString, type DidString, type NsidString, type TypedLexMap } from '@atproto/lex';
 import type { DataPlaneClient } from '../data-plane/client/index.js';
-import { type ExternalHydrationRoot, type ExternalHydrationWork } from '../telemetry/events.js';
+import { type ExternalHydrationRoot, type ExternalHydrationWork, type HydrationXrpcEndpoint } from '../telemetry/events.js';
 import type { SiteStandardDocumentRecord, SiteStandardPublicationRecord } from '../views/types.js';
 import type { Actors } from './actor.js';
 import type { Labels } from './label.js';
@@ -60,10 +60,23 @@ export declare class ExternalHydrator {
     static readonly MAX_BACKLINK_FANOUT = 8;
     /** Hard cap on generic batches per traversal, counting the root as pass 1. */
     static readonly MAX_EXTERNAL_HYDRATION_PASSES = 8;
+    /**
+     * Entries per generic record RPC. The dataplane rejects larger URI lookups;
+     * exact-ref lookups use the same bound defensively.
+     */
+    static readonly MAX_RECORDS_PER_REQUEST = 100;
     constructor(dataplane: DataPlaneClient);
-    /** Fetch exact record versions; unavailable records are represented by null. */
+    /**
+     * Fetch exact record versions; unavailable records are represented by null.
+     * Large inputs are fetched in sequential bounded requests; any failed request
+     * rejects the whole call.
+     */
     getRecordsByRef(refs: Required<ItemRef>[], includeTakedowns?: boolean): Promise<ExternalRecordsByRef>;
-    /** Fetch the latest indexed versions without collection-specific validation. */
+    /**
+     * Fetch the latest indexed versions without collection-specific validation.
+     * Large inputs are fetched in sequential bounded requests; any failed request
+     * rejects the whole call.
+     */
     getRecordsByURI(uris: AtUriString[], includeTakedowns?: boolean): Promise<ExternalRecords>;
     /** Fetch a page of activity refs for subsequent generic record hydration. */
     getAtmosphereTimeline(viewerDid: DidString, opts?: {
@@ -115,18 +128,28 @@ export declare function actionExternalRecordTakedowns({ externalRecords, externa
 }, includeTakedowns?: boolean): void;
 /**
  * Generic lookup work of one external hydration traversal, shared by reference
- * through its nested passes. `capped` records hitting the pass limit.
+ * through its nested passes. `capped` records hitting the pass limit; `partial`
+ * records a recovered best-effort dependency failure.
  */
 export type ExternalHydrationTracker = ExternalHydrationWork & {
     capped: boolean;
+    partial: boolean;
+    /**
+     * Internal: set by the traversal's first dependency discovery, whose refs
+     * are its roots.
+     */
+    rootsCounted: boolean;
 };
 /**
  * Run `fn` with the caller's tracker, or as the owner of a new traversal when
- * there is none. Only the owner reports, once, including on failure. Owners
- * that completed without scheduling a batch did no work and are not reported;
- * caps and failures always are.
+ * there is none. Only the owner reports, once, including on failure, with the
+ * context's XRPC endpoint (`'unknown'` if unset) and the traversal's wall time. A
+ * returned traversal is `capped` if it hit the pass limit, else `partial` if
+ * it recovered from a dependency failure. Owners that completed without
+ * scheduling a batch did no work and are not reported; other outcomes always
+ * are.
  */
-export declare function trackExternalHydration<T>(root: ExternalHydrationRoot, hydrationMetrics: ExternalHydrationTracker | undefined, fn: (hydrationMetrics: ExternalHydrationTracker) => Promise<T>): Promise<T>;
+export declare function trackExternalHydration<T>(root: ExternalHydrationRoot, xrpcEndpoint: HydrationXrpcEndpoint | undefined, hydrationMetrics: ExternalHydrationTracker | undefined, fn: (hydrationMetrics: ExternalHydrationTracker) => Promise<T>): Promise<T>;
 export type AssociatedSiteStandardRecord<T> = {
     ref: {
         uri: AtUriString;

package/dist/hydration/external.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../src/hydration/external.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,SAAS,EAEd,KAAK,UAAU,EAEf,KAAK,WAAW,EAGjB,MAAM,cAAc,CAAA;AAErB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAOpE,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAE3B,MAAM,wBAAwB,CAAA;AAE/B,OAAO,KAAK,EACV,0BAA0B,EAC1B,6BAA6B,EAC9B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EACL,YAAY,EACZ,KAAK,OAAO,EACZ,KAAK,UAAU,EAGhB,MAAM,WAAW,CAAA;AAElB,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC,CAAA;AACpD,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC,WAAW,EAAE,cAAc,CAAC,CAAA;AACvE,6EAA6E;AAC7E,MAAM,MAAM,oBAAoB,GAAG,YAAY,CAAC,cAAc,EAAE,cAAc,CAAC,CAAA;AAC/E,MAAM,MAAM,uBAAuB,GAAG,YAAY,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,CAAA;AAE9E,MAAM,MAAM,sBAAsB,GAAG;IACnC,GAAG,EAAE,WAAW,CAAA;IAChB,QAAQ,EAAE,IAAI,CAAA;CACf,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,sBAAsB,EAAE,CAAA;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,sBAAsB,EAAE,CAAA;IACnC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG,YAAY,CACrD,WAAW,EACX,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CACpC,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,YAAY,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,CAAA;IACnD,SAAS,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,OAAO,CAAC,MAAM,oBAAoB,EAAE,OAAO,MAAM,CAAA;AAEjD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IAAE,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAA;AAEtE,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,0BAA0B,CAAC,CAAA;AACzE,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC,6BAA6B,CAAC,CAAA;AAE/E;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAC9C,cAAc,EACd,oBAAoB,CACrB,CAAA;AACD;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,YAAY,CACjD,cAAc,EACd,uBAAuB,CACxB,CAAA;AACD,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,qBAAqB,CAAA;IAChC,YAAY,EAAE,wBAAwB,CAAA;CACvC,CAAA;AAED,qBAAa,gBAAgB;IAOR,SAAS,EAAE,eAAe;IAN7C,MAAM,CAAC,QAAQ,CAAC,qBAAqB,KAAI;IACzC,MAAM,CAAC,QAAQ,CAAC,0BAA0B,MAAK;IAC/C,MAAM,CAAC,QAAQ,CAAC,mBAAmB,KAAI;IACvC,8EAA8E;IAC9E,MAAM,CAAC,QAAQ,CAAC,6BAA6B,KAAI;IAEjD,YAAmB,SAAS,EAAE,eAAe,EAAI;IAEjD,gFAAgF;IAC1E,eAAe,CACnB,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,EACzB,gBAAgB,UAAQ,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAY/B;IAED,gFAAgF;IAC1E,eAAe,CACnB,IAAI,EAAE,WAAW,EAAE,EACnB,gBAAgB,UAAQ,GACvB,OAAO,CAAC,eAAe,CAAC,CAY1B;IAED,6EAA6E;IACvE,qBAAqB,CACzB,SAAS,EAAE,SAAS,EACpB,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAC7C,OAAO,CAAC,kBAAkB,CAAC,CAY7B;IAED,2EAA2E;IACrE,2BAA2B,CAC/B,UAAU,EAAE,WAAW,EAAE,EACzB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,4BAA4B,CAAC,CAoBvC;IAED,0DAA0D;IACpD,sBAAsB,CAC1B,SAAS,EAAE,WAAW,EACtB,UAAU,EAAE,UAAU,EACtB,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAC7C,OAAO,CAAC,mBAAmB,CAAC,CAa9B;IAED,8EAA8E;IACxE,6BAA6B,CACjC,UAAU,EAAE,WAAW,EAAE,EACzB,QAAQ,EAAE,SAAS,EACnB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,0BAA0B,CAAC,CAiBrC;IAED;;;OAGG;IACG,2BAA2B,CAC/B,IAAI,EAAE,OAAO,EAAE,EACf,gBAAgB,UAAQ,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAa9B;CACF;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,cAAc,CAAA;AACxE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAA;AAOtD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,CAS5E;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,EACE,eAAe,EACf,oBAAoB,EACpB,MAAM,EACN,MAAM,GACP,EAAE;IACD,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,EACD,gBAAgB,CAAC,EAAE,OAAO,GACzB,IAAI,CAgBN;AAED;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,qBAAqB,GAAG;IAC7D,MAAM,EAAE,OAAO,CAAA;CAChB,CAAA;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,IAAI,EAAE,qBAAqB,EAC3B,gBAAgB,EAAE,wBAAwB,GAAG,SAAS,EACtD,EAAE,EAAE,CAAC,gBAAgB,EAAE,wBAAwB,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7D,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAyFD,MAAM,MAAM,4BAA4B,CAAC,CAAC,IAAI;IAC5C,GAAG,EAAE;QAAE,GAAG,EAAE,WAAW,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACtC,IAAI,EAAE,CAAC,CAAA;CACR,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,6CAA6C,mBACxC,SAAS;IAAE,GAAG,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,SAAS,aAC7D,qBAAqB,GAAG,SAAS,gBAC9B,wBAAwB,GAAG,SAAS,KACjD;IACD,QAAQ,EAAE,4BAA4B,CAAC,oBAAoB,CAAC,GAAG,SAAS,CAAA;IACxE,WAAW,EAAE,4BAA4B,CAAC,uBAAuB,CAAC,GAAG,SAAS,CAAA;CAuD/E,CAAA"}
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../src/hydration/external.ts"],"names":[],"mappings":"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"}

package/dist/hydration/external.js

@@ -1,3 +1,5 @@
+import { performance } from 'node:perf_hooks';
+import { chunkArray } from '@atproto/common';
 import { isTypedLexMap, lexParseJsonBytes, } from '@atproto/lex';
 import { parseAtUriString } from '@atproto/syntax';
 import { site } from '../lexicons/index.js';
@@ -12,28 +14,43 @@ export class ExternalHydrator {
     static { this.MAX_BACKLINK_FANOUT = 8; }
     /** Hard cap on generic batches per traversal, counting the root as pass 1. */
     static { this.MAX_EXTERNAL_HYDRATION_PASSES = 8; }
+    /**
+     * Entries per generic record RPC. The dataplane rejects larger URI lookups;
+     * exact-ref lookups use the same bound defensively.
+     */
+    static { this.MAX_RECORDS_PER_REQUEST = 100; }
     constructor(dataplane) {
         this.dataplane = dataplane;
     }
-    /** Fetch exact record versions; unavailable records are represented by null. */
+    /**
+     * Fetch exact record versions; unavailable records are represented by null.
+     * Large inputs are fetched in sequential bounded requests; any failed request
+     * rejects the whole call.
+     */
     async getRecordsByRef(refs, includeTakedowns = false) {
         const map = new HydrationMap();
-        if (!refs.length)
-            return map;
-        const res = await this.dataplane.getRecordsByRef({ refs });
-        for (let i = 0; i < refs.length; i++) {
-            map.set(genericRecordKey(refs[i]), parseGenericRecord(res.results[i], includeTakedowns) ?? null);
+        for (const chunk of chunkArray(refs, ExternalHydrator.MAX_RECORDS_PER_REQUEST)) {
+            const res = await this.dataplane.getRecordsByRef({ refs: chunk });
+            // Results are positional within each request.
+            for (let i = 0; i < chunk.length; i++) {
+                map.set(genericRecordKey(chunk[i]), parseGenericRecord(res.results[i], includeTakedowns) ?? null);
+            }
         }
         return map;
     }
-    /** Fetch the latest indexed versions without collection-specific validation. */
+    /**
+     * Fetch the latest indexed versions without collection-specific validation.
+     * Large inputs are fetched in sequential bounded requests; any failed request
+     * rejects the whole call.
+     */
     async getRecordsByURI(uris, includeTakedowns = false) {
         const map = new HydrationMap();
-        if (!uris.length)
-            return map;
-        const res = await this.dataplane.getRecordsByURI({ uris });
-        for (let i = 0; i < uris.length; i++) {
-            map.set(uris[i], parseGenericRecord(res.results[i], includeTakedowns) ?? null);
+        for (const chunk of chunkArray(uris, ExternalHydrator.MAX_RECORDS_PER_REQUEST)) {
+            const res = await this.dataplane.getRecordsByURI({ uris: chunk });
+            // Results are positional within each request.
+            for (let i = 0; i < chunk.length; i++) {
+                map.set(chunk[i], parseGenericRecord(res.results[i], includeTakedowns) ?? null);
+            }
         }
         return map;
     }
@@ -160,29 +177,49 @@ export function actionExternalRecordTakedowns({ externalRecords, externalRecords
 }
 /**
  * Run `fn` with the caller's tracker, or as the owner of a new traversal when
- * there is none. Only the owner reports, once, including on failure. Owners
- * that completed without scheduling a batch did no work and are not reported;
- * caps and failures always are.
+ * there is none. Only the owner reports, once, including on failure, with the
+ * context's XRPC endpoint (`'unknown'` if unset) and the traversal's wall time. A
+ * returned traversal is `capped` if it hit the pass limit, else `partial` if
+ * it recovered from a dependency failure. Owners that completed without
+ * scheduling a batch did no work and are not reported; other outcomes always
+ * are.
  */
-export async function trackExternalHydration(root, hydrationMetrics, fn) {
+export async function trackExternalHydration(root, xrpcEndpoint, hydrationMetrics, fn) {
     if (hydrationMetrics)
         return fn(hydrationMetrics);
-    const owned = { recordLookups: 0, batches: 0, maxPass: 0, capped: false };
+    const owned = {
+        recordLookups: 0,
+        batches: 0,
+        maxPass: 0,
+        roots: 0,
+        rootsResolved: 0,
+        dependencies: 0,
+        dependenciesResolved: 0,
+        capped: false,
+        partial: false,
+        rootsCounted: false,
+    };
     let outcome = 'failed';
+    const start = performance.now();
     try {
         const state = await fn(owned);
-        outcome = owned.capped ? 'capped' : 'completed';
+        outcome = owned.capped ? 'capped' : owned.partial ? 'partial' : 'completed';
         return state;
     }
     finally {
         if (owned.batches || outcome !== 'completed') {
-            const { recordLookups, batches, maxPass } = owned;
             events.externalHydrationTraversal({
+                xrpcEndpoint: xrpcEndpoint ?? 'unknown',
                 root,
                 outcome,
-                recordLookups,
-                batches,
-                maxPass,
+                durationMs: performance.now() - start,
+                recordLookups: owned.recordLookups,
+                batches: owned.batches,
+                maxPass: owned.maxPass,
+                roots: owned.roots,
+                rootsResolved: owned.rootsResolved,
+                dependencies: owned.dependencies,
+                dependenciesResolved: owned.dependenciesResolved,
             });
         }
     }

package/dist/hydration/external.js.map

@@ -1 +1 @@
-{"version":3,"file":"external.js","sourceRoot":"","sources":["../../src/hydration/external.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type AtUriString,\n  type DidString,\n  type InferInput,\n  type NsidString,\n  type RecordSchema,\n  type TypedLexMap,\n  isTypedLexMap,\n  lexParseJsonBytes,\n} from '@atproto/lex'\nimport { parseAtUriString } from '@atproto/syntax'\nimport type { DataPlaneClient } from '../data-plane/client/index.js'\nimport { site } from '../lexicons/index.js'\nimport { hydrationLogger } from '../logger.js'\nimport {\n  type RecordLookupResult,\n  RecordLookupStatus,\n} from '../proto/bsky_pb.js'\nimport {\n  type ExternalHydrationOutcome,\n  type ExternalHydrationRoot,\n  type ExternalHydrationWork,\n  events,\n} from '../telemetry/events.js'\nimport { uriToDid } from '../util/uris.js'\nimport type {\n  SiteStandardDocumentRecord,\n  SiteStandardPublicationRecord,\n} from '../views/types.js'\nimport type { Actors } from './actor.js'\nimport type { Labels } from './label.js'\nimport {\n  HydrationMap,\n  type ItemRef,\n  type RecordInfo,\n  parseDate,\n  safeTakedownRef,\n} from './util.js'\n\n/** Generic record bodies are decoded, but not validated against a Lexicon. */\nexport type ExternalRecord = RecordInfo<TypedLexMap>\nexport type ExternalRecords = HydrationMap<AtUriString, ExternalRecord>\n/** Keyed by `genericRecordKey({ uri, cid })` to retain versions of a URI. */\nexport type ExternalRecordsByRef = HydrationMap<ExactRecordKey, ExternalRecord>\nexport type ExternalRecordBacklinks = HydrationMap<AtUriString, AtUriString[]>\n\nexport type AtmosphereActivityItem = {\n  uri: AtUriString\n  sortedAt: Date\n}\n\nexport type AtmosphereTimeline = {\n  items: AtmosphereActivityItem[]\n  cursor?: string\n}\n\nexport type AtmosphereBacklinks = {\n  backlinks: AtmosphereActivityItem[]\n  cursor?: string\n}\n\nexport type ExternalRecordBacklinkCounts = HydrationMap<\n  AtUriString,\n  Partial<Record<NsidString, number>>\n>\n\nexport type AtmosphereBacklinksByActor = {\n  backlinks: HydrationMap<AtUriString, AtUriString[]>\n  truncated: boolean\n}\n\ndeclare const exactRecordKeySymbol: unique symbol\n\n/**\n * A version-exact `${uri}@${cid}` key, only produced by `genericRecordKey` for\n * a ref with a CID, so it can be parsed back by `parseGenericRecordKey`.\n */\nexport type ExactRecordKey = string & { [exactRecordKeySymbol]: true }\n\nexport type SiteStandardDocument = RecordInfo<SiteStandardDocumentRecord>\nexport type SiteStandardPublication = RecordInfo<SiteStandardPublicationRecord>\n\n/**\n * Keyed by `${uri}@${cid}` — see `genericRecordKey`. A single hydration\n * batch can pull more than one version of the same URI (different posts\n * pinning different cids), so the composite key is needed for O(1)\n * version-exact lookups.\n */\nexport type SiteStandardDocuments = HydrationMap<\n  ExactRecordKey,\n  SiteStandardDocument\n>\n/**\n * Keyed by `${uri}@${cid}`. See `SiteStandardDocuments` for the rationale.\n */\nexport type SiteStandardPublications = HydrationMap<\n  ExactRecordKey,\n  SiteStandardPublication\n>\nexport type SiteStandardRecords = {\n  documents: SiteStandardDocuments\n  publications: SiteStandardPublications\n}\n\nexport class ExternalHydrator {\n  static readonly MAX_BACKLINK_PREVIEWS = 3\n  static readonly MAX_BACKLINK_GALLERY_ITEMS = 10\n  static readonly MAX_BACKLINK_FANOUT = 8\n  /** Hard cap on generic batches per traversal, counting the root as pass 1. */\n  static readonly MAX_EXTERNAL_HYDRATION_PASSES = 8\n\n  constructor(public dataplane: DataPlaneClient) {}\n\n  /** Fetch exact record versions; unavailable records are represented by null. */\n  async getRecordsByRef(\n    refs: Required<ItemRef>[],\n    includeTakedowns = false,\n  ): Promise<ExternalRecordsByRef> {\n    const map: ExternalRecordsByRef = new HydrationMap()\n    if (!refs.length) return map\n\n    const res = await this.dataplane.getRecordsByRef({ refs })\n    for (let i = 0; i < refs.length; i++) {\n      map.set(\n        genericRecordKey(refs[i]),\n        parseGenericRecord(res.results[i], includeTakedowns) ?? null,\n      )\n    }\n    return map\n  }\n\n  /** Fetch the latest indexed versions without collection-specific validation. */\n  async getRecordsByURI(\n    uris: AtUriString[],\n    includeTakedowns = false,\n  ): Promise<ExternalRecords> {\n    const map: ExternalRecords = new HydrationMap()\n    if (!uris.length) return map\n\n    const res = await this.dataplane.getRecordsByURI({ uris })\n    for (let i = 0; i < uris.length; i++) {\n      map.set(\n        uris[i],\n        parseGenericRecord(res.results[i], includeTakedowns) ?? null,\n      )\n    }\n    return map\n  }\n\n  /** Fetch a page of activity refs for subsequent generic record hydration. */\n  async getAtmosphereTimeline(\n    viewerDid: DidString,\n    opts: { limit?: number; cursor?: string } = {},\n  ): Promise<AtmosphereTimeline> {\n    const res = await this.dataplane.getAtmosphereTimeline({\n      viewerDid,\n      ...opts,\n    })\n    return {\n      items: res.items.map((item) => ({\n        uri: item.uri as AtUriString,\n        sortedAt: parseDate(item.sortedAt) ?? new Date(0),\n      })),\n      cursor: res.cursor || undefined,\n    }\n  }\n\n  /** Fetch source-record counts, optionally restricted to one collection. */\n  async getAtmosphereBacklinkCounts(\n    targetUris: AtUriString[],\n    collection?: NsidString,\n  ): Promise<ExternalRecordBacklinkCounts> {\n    const map: ExternalRecordBacklinkCounts = new HydrationMap()\n    if (!targetUris.length) return map\n\n    const res = await this.dataplane.getAtmosphereBacklinkCounts({\n      targetUris,\n      collection,\n    })\n    for (const result of res.results) {\n      map.set(\n        result.targetUri as AtUriString,\n        Object.fromEntries(\n          Object.entries(result.counts).map(([nsid, count]) => [\n            nsid,\n            Number(count),\n          ]),\n        ),\n      )\n    }\n    return map\n  }\n\n  /** Fetch a page of source records linking to a target. */\n  async getAtmosphereBacklinks(\n    targetUri: AtUriString,\n    collection: NsidString,\n    opts: { limit?: number; cursor?: string } = {},\n  ): Promise<AtmosphereBacklinks> {\n    const res = await this.dataplane.getAtmosphereBacklinks({\n      targetUri,\n      collection,\n      ...opts,\n    })\n    return {\n      backlinks: res.backlinks.map((backlink) => ({\n        uri: backlink.uri as AtUriString,\n        sortedAt: parseDate(backlink.sortedAt) ?? new Date(0),\n      })),\n      cursor: res.cursor || undefined,\n    }\n  }\n\n  /** Fetch an actor's links per target, retaining the batch truncation flag. */\n  async getAtmosphereBacklinksByActor(\n    targetUris: AtUriString[],\n    actorDid: DidString,\n    collection: NsidString,\n  ): Promise<AtmosphereBacklinksByActor> {\n    const backlinks: AtmosphereBacklinksByActor['backlinks'] =\n      new HydrationMap()\n    if (!targetUris.length) return { backlinks, truncated: false }\n\n    const res = await this.dataplane.getAtmosphereBacklinksByActor({\n      targetUris,\n      actorDid,\n      collection,\n    })\n    for (const result of res.results) {\n      backlinks.set(\n        result.targetUri as AtUriString,\n        result.uris as AtUriString[],\n      )\n    }\n    return { backlinks, truncated: res.truncated }\n  }\n\n  /**\n   * Fetch exact `site.standard.{document,publication}` versions. Does NOT\n   * resolve a document's publication; callers must pin it explicitly.\n   */\n  async getSiteStandardRecordsByRef(\n    refs: ItemRef[],\n    includeTakedowns = false,\n  ): Promise<SiteStandardRecords> {\n    const ssRefs = refs.filter(\n      (ref): ref is Required<ItemRef> =>\n        !!ref.cid && siteStandardKind(ref.uri) !== undefined,\n    )\n    const out = emptySiteStandardRecords()\n    if (!ssRefs.length) return out\n\n    const records = await this.getRecordsByRef(ssRefs, includeTakedowns)\n    for (const [key, info] of records) {\n      setSiteStandardRecord(out, parseGenericRecordKey(key).uri, key, info)\n    }\n    return out\n  }\n}\n\n/**\n * Composes the lookup key for a ref: the bare URI for a latest-version lookup,\n * or `${uri}@${cid}` for an exact version. A single hydration batch can pull\n * several versions of one URI (different posts pinning different cids), so\n * exact maps need the composite for O(1) version-exact lookups. The two forms\n * never collide, so latest and exact lookups can share one traversal set.\n *\n * Throws on an empty CID rather than treating it as a latest lookup.\n */\nexport function genericRecordKey(ref: Required<ItemRef>): ExactRecordKey\nexport function genericRecordKey(ref: ItemRef): string\nexport function genericRecordKey({ uri, cid }: ItemRef): string {\n  if (cid === undefined) return uri\n  if (!cid) throw new Error(`Empty CID in record key for ${uri}`)\n  return `${uri}@${cid}`\n}\n\n/**\n * Recover the URI and CID from an exact record key, splitting at the last `@`.\n * Throws if either part is missing. Components are trusted, not revalidated.\n */\nexport function parseGenericRecordKey(key: ExactRecordKey): Required<ItemRef> {\n  const at = key.lastIndexOf('@')\n  if (at <= 0 || at === key.length - 1) {\n    throw new Error(`Malformed exact record key: ${key}`)\n  }\n  return {\n    uri: key.slice(0, at) as AtUriString,\n    cid: key.slice(at + 1),\n  }\n}\n\n/**\n * Null generic external records (in both the URI-keyed and exact-ref maps,\n * keeping their keys) that are taken down by an actionable label, unless\n * takedowns are included, or whose owner is explicitly unavailable. Applies to\n * each record independently; counts and other records are unaffected.\n */\nexport function actionExternalRecordTakedowns(\n  {\n    externalRecords,\n    externalRecordsByRef,\n    actors,\n    labels,\n  }: {\n    externalRecords?: ExternalRecords\n    externalRecordsByRef?: ExternalRecordsByRef\n    actors?: Actors\n    labels?: Labels\n  },\n  includeTakedowns?: boolean,\n): void {\n  // An absent actor entry was not hydrated; only `null` means unavailable.\n  const isHidden = (uri: AtUriString) =>\n    actors?.get(uriToDid(uri)) === null ||\n    (!includeTakedowns && labels?.get(uri)?.isTakendown)\n  for (const [uri, info] of externalRecords ?? []) {\n    if (!info || !isHidden(uri)) continue\n    externalRecords?.set(uri, null)\n    externalRecordsByRef?.set(genericRecordKey({ uri, cid: info.cid }), null)\n  }\n  // Every exact version is checked on its own; versions are never collapsed.\n  for (const [key, info] of externalRecordsByRef ?? []) {\n    if (info && isHidden(parseGenericRecordKey(key).uri)) {\n      externalRecordsByRef?.set(key, null)\n    }\n  }\n}\n\n/**\n * Generic lookup work of one external hydration traversal, shared by reference\n * through its nested passes. `capped` records hitting the pass limit.\n */\nexport type ExternalHydrationTracker = ExternalHydrationWork & {\n  capped: boolean\n}\n\n/**\n * Run `fn` with the caller's tracker, or as the owner of a new traversal when\n * there is none. Only the owner reports, once, including on failure. Owners\n * that completed without scheduling a batch did no work and are not reported;\n * caps and failures always are.\n */\nexport async function trackExternalHydration<T>(\n  root: ExternalHydrationRoot,\n  hydrationMetrics: ExternalHydrationTracker | undefined,\n  fn: (hydrationMetrics: ExternalHydrationTracker) => Promise<T>,\n): Promise<T> {\n  if (hydrationMetrics) return fn(hydrationMetrics)\n  const owned = { recordLookups: 0, batches: 0, maxPass: 0, capped: false }\n  let outcome: ExternalHydrationOutcome = 'failed'\n  try {\n    const state = await fn(owned)\n    outcome = owned.capped ? 'capped' : 'completed'\n    return state\n  } finally {\n    if (owned.batches || outcome !== 'completed') {\n      const { recordLookups, batches, maxPass } = owned\n      events.externalHydrationTraversal({\n        root,\n        outcome,\n        recordLookups,\n        batches,\n        maxPass,\n      })\n    }\n  }\n}\n\nfunction parseGenericRecord(\n  result: RecordLookupResult | undefined,\n  includeTakedowns: boolean,\n): ExternalRecord | undefined {\n  if (\n    result?.status !== RecordLookupStatus.FOUND &&\n    !(includeTakedowns && result?.status === RecordLookupStatus.TAKEN_DOWN)\n  ) {\n    return undefined\n  }\n  const entry = result.record\n  if (!entry?.cid || !entry.record.byteLength) return undefined\n  if (!includeTakedowns && entry.takenDown) return undefined\n\n  let record: ReturnType<typeof lexParseJsonBytes>\n  try {\n    record = lexParseJsonBytes(entry.record, { strict: false })\n  } catch {\n    return undefined\n  }\n  if (!isTypedLexMap(record)) return undefined\n\n  return {\n    record,\n    cid: entry.cid,\n    sortedAt: parseDate(entry.sortedAt) ?? new Date(0),\n    indexedAt: parseDate(entry.indexedAt) ?? new Date(0),\n    takedownRef: safeTakedownRef(entry),\n  }\n}\n\nconst emptySiteStandardRecords = (): SiteStandardRecords => ({\n  documents: new HydrationMap(),\n  publications: new HydrationMap(),\n})\n\nconst siteStandardKind = (\n  uri: string,\n): keyof SiteStandardRecords | undefined => {\n  const parsed = parseAtUriString(uri)\n  if (!parsed.success) return undefined\n  switch (parsed.value.collection) {\n    case site.standard.document.$type:\n      return 'documents'\n    case site.standard.publication.$type:\n      return 'publications'\n    default:\n      return undefined\n  }\n}\n\n/**\n * Generic record bodies are unvalidated, so check them against the Lexicon\n * before exposing typed fields. Parse mode is not used, to preserve the\n * stored record as-is.\n */\nconst matchRecordInfo = <TSchema extends RecordSchema>(\n  schema: TSchema,\n  info: ExternalRecord | null | undefined,\n): RecordInfo<InferInput<TSchema>> | null =>\n  info && schema.$matches(info.record, { strict: false })\n    ? { ...info, record: info.record }\n    : null\n\n/**\n * Store a generic record in the map matching its collection. Records failing\n * Lexicon validation are stored as null.\n */\nconst setSiteStandardRecord = (\n  out: SiteStandardRecords,\n  uri: string,\n  key: ExactRecordKey,\n  info: ExternalRecord | null | undefined,\n) => {\n  switch (siteStandardKind(uri)) {\n    case 'documents':\n      out.documents.set(key, matchRecordInfo(site.standard.document.main, info))\n      break\n    case 'publications':\n      out.publications.set(\n        key,\n        matchRecordInfo(site.standard.publication.main, info),\n      )\n      break\n  }\n}\n\nexport type AssociatedSiteStandardRecord<T> = {\n  ref: { uri: AtUriString; cid: string }\n  info: T\n}\n\n/**\n * Read-path resolution: caller pinned a set of `(uri, cid)` strongRefs in\n * the post at write time, and we honor those exact versions. Any pair\n * that doesn't structurally agree is rejected, so downstream callers can\n * trust the returned shape.\n *\n * Pairing rules:\n * - Both slots referenced: `doc.site` must equal `publication.ref.uri`,\n *   else both come back `undefined`.\n * - Doc with at-uri `site` referenced but no matching publication ref:\n *   reject the whole pairing (doc claims a publication that should have\n *   been pinned, but wasn't).\n * - Loose doc (web-URL `site`) referenced: publication stays `undefined`.\n * - Only a publication referenced: document stays `undefined`.\n *\n * Each returned slot carries the matching `ref` so callers can recover\n * the owner DID for blob-cdn URL building, etc.\n */\nexport const getSiteStandardRecordsFromHydrationMapsByRefs = (\n  associatedRefs: readonly { uri: AtUriString; cid: string }[] | undefined,\n  documents: SiteStandardDocuments | undefined,\n  publications: SiteStandardPublications | undefined,\n): {\n  document: AssociatedSiteStandardRecord<SiteStandardDocument> | undefined\n  publication: AssociatedSiteStandardRecord<SiteStandardPublication> | undefined\n} => {\n  if (!associatedRefs?.length) {\n    return { document: undefined, publication: undefined }\n  }\n\n  // Resolve each ref against the hydration maps, taking the first hit on\n  // each side.\n  let document: AssociatedSiteStandardRecord<SiteStandardDocument> | undefined\n  let publication:\n    AssociatedSiteStandardRecord<SiteStandardPublication> | undefined\n  for (const ref of associatedRefs) {\n    const key = genericRecordKey(ref)\n    if (!document) {\n      const hit = documents?.get(key)\n      if (hit) document = { ref, info: hit }\n    }\n    if (!publication) {\n      const hit = publications?.get(key)\n      if (hit) publication = { ref, info: hit }\n    }\n    if (document && publication) break\n  }\n\n  // Both refs resolved: enforce that the doc's `site` actually points at\n  // the supplied publication. Mismatch means the post was misconstructed\n  // (or tampered with), so reject the whole pairing.\n  if (document && publication) {\n    if (document.info.record.site !== publication.ref.uri) {\n      hydrationLogger.warn(\n        {\n          documentUri: document.ref.uri,\n          documentSite: document.info.record.site,\n          publicationUri: publication.ref.uri,\n        },\n        'site.standard byRefs lookup failed: doc.site does not match hydrated publication.uri',\n      )\n      return { document: undefined, publication: undefined }\n    }\n  }\n\n  // Doc with at-uri `site` but no publication: the post should have\n  // pinned the publication too. Treat as misconstructed.\n  if (document && !publication) {\n    const site = document.info.record.site\n    if (site && site.startsWith('at://')) {\n      hydrationLogger.warn(\n        { documentUri: document.ref.uri, documentSite: site },\n        'site.standard byRefs lookup failed: document.site is AT URI but no matching publication was hydrated',\n      )\n      return { document: undefined, publication: undefined }\n    }\n  }\n\n  return { document, publication }\n}\n"]}
+{"version":3,"file":"external.js","sourceRoot":"","sources":["../../src/hydration/external.ts"],"names":[],"mappings":"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","sourcesContent":["import { performance } from 'node:perf_hooks'\nimport { chunkArray } from '@atproto/common'\nimport {\n  type AtUriString,\n  type DidString,\n  type InferInput,\n  type NsidString,\n  type RecordSchema,\n  type TypedLexMap,\n  isTypedLexMap,\n  lexParseJsonBytes,\n} from '@atproto/lex'\nimport { parseAtUriString } from '@atproto/syntax'\nimport type { DataPlaneClient } from '../data-plane/client/index.js'\nimport { site } from '../lexicons/index.js'\nimport { hydrationLogger } from '../logger.js'\nimport {\n  type RecordLookupResult,\n  RecordLookupStatus,\n} from '../proto/bsky_pb.js'\nimport {\n  type ExternalHydrationOutcome,\n  type ExternalHydrationRoot,\n  type ExternalHydrationWork,\n  type HydrationXrpcEndpoint,\n  events,\n} from '../telemetry/events.js'\nimport { uriToDid } from '../util/uris.js'\nimport type {\n  SiteStandardDocumentRecord,\n  SiteStandardPublicationRecord,\n} from '../views/types.js'\nimport type { Actors } from './actor.js'\nimport type { Labels } from './label.js'\nimport {\n  HydrationMap,\n  type ItemRef,\n  type RecordInfo,\n  parseDate,\n  safeTakedownRef,\n} from './util.js'\n\n/** Generic record bodies are decoded, but not validated against a Lexicon. */\nexport type ExternalRecord = RecordInfo<TypedLexMap>\nexport type ExternalRecords = HydrationMap<AtUriString, ExternalRecord>\n/** Keyed by `genericRecordKey({ uri, cid })` to retain versions of a URI. */\nexport type ExternalRecordsByRef = HydrationMap<ExactRecordKey, ExternalRecord>\nexport type ExternalRecordBacklinks = HydrationMap<AtUriString, AtUriString[]>\n\nexport type AtmosphereActivityItem = {\n  uri: AtUriString\n  sortedAt: Date\n}\n\nexport type AtmosphereTimeline = {\n  items: AtmosphereActivityItem[]\n  cursor?: string\n}\n\nexport type AtmosphereBacklinks = {\n  backlinks: AtmosphereActivityItem[]\n  cursor?: string\n}\n\nexport type ExternalRecordBacklinkCounts = HydrationMap<\n  AtUriString,\n  Partial<Record<NsidString, number>>\n>\n\nexport type AtmosphereBacklinksByActor = {\n  backlinks: HydrationMap<AtUriString, AtUriString[]>\n  truncated: boolean\n}\n\ndeclare const exactRecordKeySymbol: unique symbol\n\n/**\n * A version-exact `${uri}@${cid}` key, only produced by `genericRecordKey` for\n * a ref with a CID, so it can be parsed back by `parseGenericRecordKey`.\n */\nexport type ExactRecordKey = string & { [exactRecordKeySymbol]: true }\n\nexport type SiteStandardDocument = RecordInfo<SiteStandardDocumentRecord>\nexport type SiteStandardPublication = RecordInfo<SiteStandardPublicationRecord>\n\n/**\n * Keyed by `${uri}@${cid}` — see `genericRecordKey`. A single hydration\n * batch can pull more than one version of the same URI (different posts\n * pinning different cids), so the composite key is needed for O(1)\n * version-exact lookups.\n */\nexport type SiteStandardDocuments = HydrationMap<\n  ExactRecordKey,\n  SiteStandardDocument\n>\n/**\n * Keyed by `${uri}@${cid}`. See `SiteStandardDocuments` for the rationale.\n */\nexport type SiteStandardPublications = HydrationMap<\n  ExactRecordKey,\n  SiteStandardPublication\n>\nexport type SiteStandardRecords = {\n  documents: SiteStandardDocuments\n  publications: SiteStandardPublications\n}\n\nexport class ExternalHydrator {\n  static readonly MAX_BACKLINK_PREVIEWS = 3\n  static readonly MAX_BACKLINK_GALLERY_ITEMS = 10\n  static readonly MAX_BACKLINK_FANOUT = 8\n  /** Hard cap on generic batches per traversal, counting the root as pass 1. */\n  static readonly MAX_EXTERNAL_HYDRATION_PASSES = 8\n  /**\n   * Entries per generic record RPC. The dataplane rejects larger URI lookups;\n   * exact-ref lookups use the same bound defensively.\n   */\n  static readonly MAX_RECORDS_PER_REQUEST = 100\n\n  constructor(public dataplane: DataPlaneClient) {}\n\n  /**\n   * Fetch exact record versions; unavailable records are represented by null.\n   * Large inputs are fetched in sequential bounded requests; any failed request\n   * rejects the whole call.\n   */\n  async getRecordsByRef(\n    refs: Required<ItemRef>[],\n    includeTakedowns = false,\n  ): Promise<ExternalRecordsByRef> {\n    const map: ExternalRecordsByRef = new HydrationMap()\n    for (const chunk of chunkArray(\n      refs,\n      ExternalHydrator.MAX_RECORDS_PER_REQUEST,\n    )) {\n      const res = await this.dataplane.getRecordsByRef({ refs: chunk })\n      // Results are positional within each request.\n      for (let i = 0; i < chunk.length; i++) {\n        map.set(\n          genericRecordKey(chunk[i]),\n          parseGenericRecord(res.results[i], includeTakedowns) ?? null,\n        )\n      }\n    }\n    return map\n  }\n\n  /**\n   * Fetch the latest indexed versions without collection-specific validation.\n   * Large inputs are fetched in sequential bounded requests; any failed request\n   * rejects the whole call.\n   */\n  async getRecordsByURI(\n    uris: AtUriString[],\n    includeTakedowns = false,\n  ): Promise<ExternalRecords> {\n    const map: ExternalRecords = new HydrationMap()\n    for (const chunk of chunkArray(\n      uris,\n      ExternalHydrator.MAX_RECORDS_PER_REQUEST,\n    )) {\n      const res = await this.dataplane.getRecordsByURI({ uris: chunk })\n      // Results are positional within each request.\n      for (let i = 0; i < chunk.length; i++) {\n        map.set(\n          chunk[i],\n          parseGenericRecord(res.results[i], includeTakedowns) ?? null,\n        )\n      }\n    }\n    return map\n  }\n\n  /** Fetch a page of activity refs for subsequent generic record hydration. */\n  async getAtmosphereTimeline(\n    viewerDid: DidString,\n    opts: { limit?: number; cursor?: string } = {},\n  ): Promise<AtmosphereTimeline> {\n    const res = await this.dataplane.getAtmosphereTimeline({\n      viewerDid,\n      ...opts,\n    })\n    return {\n      items: res.items.map((item) => ({\n        uri: item.uri as AtUriString,\n        sortedAt: parseDate(item.sortedAt) ?? new Date(0),\n      })),\n      cursor: res.cursor || undefined,\n    }\n  }\n\n  /** Fetch source-record counts, optionally restricted to one collection. */\n  async getAtmosphereBacklinkCounts(\n    targetUris: AtUriString[],\n    collection?: NsidString,\n  ): Promise<ExternalRecordBacklinkCounts> {\n    const map: ExternalRecordBacklinkCounts = new HydrationMap()\n    if (!targetUris.length) return map\n\n    const res = await this.dataplane.getAtmosphereBacklinkCounts({\n      targetUris,\n      collection,\n    })\n    for (const result of res.results) {\n      map.set(\n        result.targetUri as AtUriString,\n        Object.fromEntries(\n          Object.entries(result.counts).map(([nsid, count]) => [\n            nsid,\n            Number(count),\n          ]),\n        ),\n      )\n    }\n    return map\n  }\n\n  /** Fetch a page of source records linking to a target. */\n  async getAtmosphereBacklinks(\n    targetUri: AtUriString,\n    collection: NsidString,\n    opts: { limit?: number; cursor?: string } = {},\n  ): Promise<AtmosphereBacklinks> {\n    const res = await this.dataplane.getAtmosphereBacklinks({\n      targetUri,\n      collection,\n      ...opts,\n    })\n    return {\n      backlinks: res.backlinks.map((backlink) => ({\n        uri: backlink.uri as AtUriString,\n        sortedAt: parseDate(backlink.sortedAt) ?? new Date(0),\n      })),\n      cursor: res.cursor || undefined,\n    }\n  }\n\n  /** Fetch an actor's links per target, retaining the batch truncation flag. */\n  async getAtmosphereBacklinksByActor(\n    targetUris: AtUriString[],\n    actorDid: DidString,\n    collection: NsidString,\n  ): Promise<AtmosphereBacklinksByActor> {\n    const backlinks: AtmosphereBacklinksByActor['backlinks'] =\n      new HydrationMap()\n    if (!targetUris.length) return { backlinks, truncated: false }\n\n    const res = await this.dataplane.getAtmosphereBacklinksByActor({\n      targetUris,\n      actorDid,\n      collection,\n    })\n    for (const result of res.results) {\n      backlinks.set(\n        result.targetUri as AtUriString,\n        result.uris as AtUriString[],\n      )\n    }\n    return { backlinks, truncated: res.truncated }\n  }\n\n  /**\n   * Fetch exact `site.standard.{document,publication}` versions. Does NOT\n   * resolve a document's publication; callers must pin it explicitly.\n   */\n  async getSiteStandardRecordsByRef(\n    refs: ItemRef[],\n    includeTakedowns = false,\n  ): Promise<SiteStandardRecords> {\n    const ssRefs = refs.filter(\n      (ref): ref is Required<ItemRef> =>\n        !!ref.cid && siteStandardKind(ref.uri) !== undefined,\n    )\n    const out = emptySiteStandardRecords()\n    if (!ssRefs.length) return out\n\n    const records = await this.getRecordsByRef(ssRefs, includeTakedowns)\n    for (const [key, info] of records) {\n      setSiteStandardRecord(out, parseGenericRecordKey(key).uri, key, info)\n    }\n    return out\n  }\n}\n\n/**\n * Composes the lookup key for a ref: the bare URI for a latest-version lookup,\n * or `${uri}@${cid}` for an exact version. A single hydration batch can pull\n * several versions of one URI (different posts pinning different cids), so\n * exact maps need the composite for O(1) version-exact lookups. The two forms\n * never collide, so latest and exact lookups can share one traversal set.\n *\n * Throws on an empty CID rather than treating it as a latest lookup.\n */\nexport function genericRecordKey(ref: Required<ItemRef>): ExactRecordKey\nexport function genericRecordKey(ref: ItemRef): string\nexport function genericRecordKey({ uri, cid }: ItemRef): string {\n  if (cid === undefined) return uri\n  if (!cid) throw new Error(`Empty CID in record key for ${uri}`)\n  return `${uri}@${cid}`\n}\n\n/**\n * Recover the URI and CID from an exact record key, splitting at the last `@`.\n * Throws if either part is missing. Components are trusted, not revalidated.\n */\nexport function parseGenericRecordKey(key: ExactRecordKey): Required<ItemRef> {\n  const at = key.lastIndexOf('@')\n  if (at <= 0 || at === key.length - 1) {\n    throw new Error(`Malformed exact record key: ${key}`)\n  }\n  return {\n    uri: key.slice(0, at) as AtUriString,\n    cid: key.slice(at + 1),\n  }\n}\n\n/**\n * Null generic external records (in both the URI-keyed and exact-ref maps,\n * keeping their keys) that are taken down by an actionable label, unless\n * takedowns are included, or whose owner is explicitly unavailable. Applies to\n * each record independently; counts and other records are unaffected.\n */\nexport function actionExternalRecordTakedowns(\n  {\n    externalRecords,\n    externalRecordsByRef,\n    actors,\n    labels,\n  }: {\n    externalRecords?: ExternalRecords\n    externalRecordsByRef?: ExternalRecordsByRef\n    actors?: Actors\n    labels?: Labels\n  },\n  includeTakedowns?: boolean,\n): void {\n  // An absent actor entry was not hydrated; only `null` means unavailable.\n  const isHidden = (uri: AtUriString) =>\n    actors?.get(uriToDid(uri)) === null ||\n    (!includeTakedowns && labels?.get(uri)?.isTakendown)\n  for (const [uri, info] of externalRecords ?? []) {\n    if (!info || !isHidden(uri)) continue\n    externalRecords?.set(uri, null)\n    externalRecordsByRef?.set(genericRecordKey({ uri, cid: info.cid }), null)\n  }\n  // Every exact version is checked on its own; versions are never collapsed.\n  for (const [key, info] of externalRecordsByRef ?? []) {\n    if (info && isHidden(parseGenericRecordKey(key).uri)) {\n      externalRecordsByRef?.set(key, null)\n    }\n  }\n}\n\n/**\n * Generic lookup work of one external hydration traversal, shared by reference\n * through its nested passes. `capped` records hitting the pass limit; `partial`\n * records a recovered best-effort dependency failure.\n */\nexport type ExternalHydrationTracker = ExternalHydrationWork & {\n  capped: boolean\n  partial: boolean\n  /**\n   * Internal: set by the traversal's first dependency discovery, whose refs\n   * are its roots.\n   */\n  rootsCounted: boolean\n}\n\n/**\n * Run `fn` with the caller's tracker, or as the owner of a new traversal when\n * there is none. Only the owner reports, once, including on failure, with the\n * context's XRPC endpoint (`'unknown'` if unset) and the traversal's wall time. A\n * returned traversal is `capped` if it hit the pass limit, else `partial` if\n * it recovered from a dependency failure. Owners that completed without\n * scheduling a batch did no work and are not reported; other outcomes always\n * are.\n */\nexport async function trackExternalHydration<T>(\n  root: ExternalHydrationRoot,\n  xrpcEndpoint: HydrationXrpcEndpoint | undefined,\n  hydrationMetrics: ExternalHydrationTracker | undefined,\n  fn: (hydrationMetrics: ExternalHydrationTracker) => Promise<T>,\n): Promise<T> {\n  if (hydrationMetrics) return fn(hydrationMetrics)\n  const owned: ExternalHydrationTracker = {\n    recordLookups: 0,\n    batches: 0,\n    maxPass: 0,\n    roots: 0,\n    rootsResolved: 0,\n    dependencies: 0,\n    dependenciesResolved: 0,\n    capped: false,\n    partial: false,\n    rootsCounted: false,\n  }\n  let outcome: ExternalHydrationOutcome = 'failed'\n  const start = performance.now()\n  try {\n    const state = await fn(owned)\n    outcome = owned.capped ? 'capped' : owned.partial ? 'partial' : 'completed'\n    return state\n  } finally {\n    if (owned.batches || outcome !== 'completed') {\n      events.externalHydrationTraversal({\n        xrpcEndpoint: xrpcEndpoint ?? 'unknown',\n        root,\n        outcome,\n        durationMs: performance.now() - start,\n        recordLookups: owned.recordLookups,\n        batches: owned.batches,\n        maxPass: owned.maxPass,\n        roots: owned.roots,\n        rootsResolved: owned.rootsResolved,\n        dependencies: owned.dependencies,\n        dependenciesResolved: owned.dependenciesResolved,\n      })\n    }\n  }\n}\n\nfunction parseGenericRecord(\n  result: RecordLookupResult | undefined,\n  includeTakedowns: boolean,\n): ExternalRecord | undefined {\n  if (\n    result?.status !== RecordLookupStatus.FOUND &&\n    !(includeTakedowns && result?.status === RecordLookupStatus.TAKEN_DOWN)\n  ) {\n    return undefined\n  }\n  const entry = result.record\n  if (!entry?.cid || !entry.record.byteLength) return undefined\n  if (!includeTakedowns && entry.takenDown) return undefined\n\n  let record: ReturnType<typeof lexParseJsonBytes>\n  try {\n    record = lexParseJsonBytes(entry.record, { strict: false })\n  } catch {\n    return undefined\n  }\n  if (!isTypedLexMap(record)) return undefined\n\n  return {\n    record,\n    cid: entry.cid,\n    sortedAt: parseDate(entry.sortedAt) ?? new Date(0),\n    indexedAt: parseDate(entry.indexedAt) ?? new Date(0),\n    takedownRef: safeTakedownRef(entry),\n  }\n}\n\nconst emptySiteStandardRecords = (): SiteStandardRecords => ({\n  documents: new HydrationMap(),\n  publications: new HydrationMap(),\n})\n\nconst siteStandardKind = (\n  uri: string,\n): keyof SiteStandardRecords | undefined => {\n  const parsed = parseAtUriString(uri)\n  if (!parsed.success) return undefined\n  switch (parsed.value.collection) {\n    case site.standard.document.$type:\n      return 'documents'\n    case site.standard.publication.$type:\n      return 'publications'\n    default:\n      return undefined\n  }\n}\n\n/**\n * Generic record bodies are unvalidated, so check them against the Lexicon\n * before exposing typed fields. Parse mode is not used, to preserve the\n * stored record as-is.\n */\nconst matchRecordInfo = <TSchema extends RecordSchema>(\n  schema: TSchema,\n  info: ExternalRecord | null | undefined,\n): RecordInfo<InferInput<TSchema>> | null =>\n  info && schema.$matches(info.record, { strict: false })\n    ? { ...info, record: info.record }\n    : null\n\n/**\n * Store a generic record in the map matching its collection. Records failing\n * Lexicon validation are stored as null.\n */\nconst setSiteStandardRecord = (\n  out: SiteStandardRecords,\n  uri: string,\n  key: ExactRecordKey,\n  info: ExternalRecord | null | undefined,\n) => {\n  switch (siteStandardKind(uri)) {\n    case 'documents':\n      out.documents.set(key, matchRecordInfo(site.standard.document.main, info))\n      break\n    case 'publications':\n      out.publications.set(\n        key,\n        matchRecordInfo(site.standard.publication.main, info),\n      )\n      break\n  }\n}\n\nexport type AssociatedSiteStandardRecord<T> = {\n  ref: { uri: AtUriString; cid: string }\n  info: T\n}\n\n/**\n * Read-path resolution: caller pinned a set of `(uri, cid)` strongRefs in\n * the post at write time, and we honor those exact versions. Any pair\n * that doesn't structurally agree is rejected, so downstream callers can\n * trust the returned shape.\n *\n * Pairing rules:\n * - Both slots referenced: `doc.site` must equal `publication.ref.uri`,\n *   else both come back `undefined`.\n * - Doc with at-uri `site` referenced but no matching publication ref:\n *   reject the whole pairing (doc claims a publication that should have\n *   been pinned, but wasn't).\n * - Loose doc (web-URL `site`) referenced: publication stays `undefined`.\n * - Only a publication referenced: document stays `undefined`.\n *\n * Each returned slot carries the matching `ref` so callers can recover\n * the owner DID for blob-cdn URL building, etc.\n */\nexport const getSiteStandardRecordsFromHydrationMapsByRefs = (\n  associatedRefs: readonly { uri: AtUriString; cid: string }[] | undefined,\n  documents: SiteStandardDocuments | undefined,\n  publications: SiteStandardPublications | undefined,\n): {\n  document: AssociatedSiteStandardRecord<SiteStandardDocument> | undefined\n  publication: AssociatedSiteStandardRecord<SiteStandardPublication> | undefined\n} => {\n  if (!associatedRefs?.length) {\n    return { document: undefined, publication: undefined }\n  }\n\n  // Resolve each ref against the hydration maps, taking the first hit on\n  // each side.\n  let document: AssociatedSiteStandardRecord<SiteStandardDocument> | undefined\n  let publication:\n    AssociatedSiteStandardRecord<SiteStandardPublication> | undefined\n  for (const ref of associatedRefs) {\n    const key = genericRecordKey(ref)\n    if (!document) {\n      const hit = documents?.get(key)\n      if (hit) document = { ref, info: hit }\n    }\n    if (!publication) {\n      const hit = publications?.get(key)\n      if (hit) publication = { ref, info: hit }\n    }\n    if (document && publication) break\n  }\n\n  // Both refs resolved: enforce that the doc's `site` actually points at\n  // the supplied publication. Mismatch means the post was misconstructed\n  // (or tampered with), so reject the whole pairing.\n  if (document && publication) {\n    if (document.info.record.site !== publication.ref.uri) {\n      hydrationLogger.warn(\n        {\n          documentUri: document.ref.uri,\n          documentSite: document.info.record.site,\n          publicationUri: publication.ref.uri,\n        },\n        'site.standard byRefs lookup failed: doc.site does not match hydrated publication.uri',\n      )\n      return { document: undefined, publication: undefined }\n    }\n  }\n\n  // Doc with at-uri `site` but no publication: the post should have\n  // pinned the publication too. Treat as misconstructed.\n  if (document && !publication) {\n    const site = document.info.record.site\n    if (site && site.startsWith('at://')) {\n      hydrationLogger.warn(\n        { documentUri: document.ref.uri, documentSite: site },\n        'site.standard byRefs lookup failed: document.site is AT URI but no matching publication was hydrated',\n      )\n      return { document: undefined, publication: undefined }\n    }\n  }\n\n  return { document, publication }\n}\n"]}

package/dist/hydration/hydrator.d.ts

@@ -4,6 +4,7 @@ import type { DataPlaneClient } from '../data-plane/client/index.js';
 import type { FeatureGatesClient, ScopedFeatureGatesClient } from '../feature-gates/index.js';
 import { app } from '../lexicons/index.js';
 import type { BookmarkInfo, Notification } from '../proto/bsky_pb.js';
+import { type HydrationXrpcEndpoint } from '../telemetry/events.js';
 import type { ParsedLabelers } from '../util.js';
 import { type ActivitySubscriptionStates, ActorHydrator, type Actors, type KnownFollowersStates, type KnownLikersStates, type ProfileAggs, type ProfileLinks, type ProfileViewerStates } from './actor.js';
 import { type ExternalHydrationTracker, ExternalHydrator, type ExternalRecordBacklinkCounts, type ExternalRecordBacklinks, type ExternalRecords, type ExternalRecordsByRef, type SiteStandardDocuments, type SiteStandardPublications } from './external.js';
@@ -21,6 +22,7 @@ export declare class HydrateCtx {
     skipViewerBlocks: boolean | undefined;
     includeDebugField: boolean | undefined;
     features: ScopedFeatureGatesClient;
+    xrpcEndpoint: HydrationXrpcEndpoint | undefined;
     constructor(vals: HydrateCtxVals);
     get skipCacheForViewer(): `did:${string}:${string}`[] | undefined;
     copy<V extends Partial<HydrateCtxVals>>(vals?: V): HydrateCtx & V;
@@ -37,6 +39,8 @@ export type HydrateCtxVals = {
     skipViewerBlocks?: boolean;
     includeDebugField?: boolean;
     features: ScopedFeatureGatesClient;
+    /** Set by handlers from their method's `$lxm`, never from request input. */
+    xrpcEndpoint?: HydrationXrpcEndpoint;
 };
 export type ListItemSubjectOptOuts = HydrationMap<AtUriString, true>;
 export type HydrationState = {

package/dist/hydration/hydrator.d.ts.map

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

package/dist/hydration/hydrator.js

@@ -27,6 +27,7 @@ export class HydrateCtx {
         this.skipViewerBlocks = this.vals.skipViewerBlocks;
         this.includeDebugField = this.vals.includeDebugField;
         this.features = this.vals.features;
+        this.xrpcEndpoint = this.vals.xrpcEndpoint;
     }
     // Convenience with use with dataplane.getActors cache control
     get skipCacheForViewer() {
@@ -628,7 +629,7 @@ export class Hydrator {
      * reports its totals.
      */
     async hydrateEmbedExternalViewFromUris(uris, ctx, seenRecordKeys = new Set(), hydrationPass = 1, hydrationMetrics) {
-        return trackExternalHydration('uris', hydrationMetrics, (hydrationMetrics) => this.hydrateEmbedExternalView(uris.map(uriToRef), ctx, seenRecordKeys, hydrationPass, hydrationMetrics));
+        return trackExternalHydration('uris', ctx.xrpcEndpoint, hydrationMetrics, (hydrationMetrics) => this.hydrateEmbedExternalView(uris.map(uriToRef), ctx, seenRecordKeys, hydrationPass, hydrationMetrics));
     }
     /**
      * Like `hydrateEmbedExternalViewFromUris`, but for exact record versions
@@ -636,7 +637,7 @@ export class Hydrator {
      * URI dependencies are hydrated as latest versions by the URI path.
      */
     async hydrateEmbedExternalViewFromRefs(refs, ctx, seenRecordKeys = new Set(), hydrationPass = 1, hydrationMetrics) {
-        return trackExternalHydration('refs', hydrationMetrics, (hydrationMetrics) => this.hydrateEmbedExternalView(refs, ctx, seenRecordKeys, hydrationPass, hydrationMetrics));
+        return trackExternalHydration('refs', ctx.xrpcEndpoint, hydrationMetrics, (hydrationMetrics) => this.hydrateEmbedExternalView(refs, ctx, seenRecordKeys, hydrationPass, hydrationMetrics));
     }
     async hydrateEmbedExternalView(refs, ctx, seenRecordKeys, hydrationPass, hydrationMetrics) {
         // Filter at the entry point so each lookup runs at most once per shared
@@ -720,12 +721,14 @@ export class Hydrator {
      * is shared as in `hydrateEmbedExternalViewFromUris`.
      */
     async hydrateExternalViewDependencies(state, refs, ctx, seenRecordKeys = new Set(), hydrationPass = 1, hydrationMetrics) {
-        return trackExternalHydration('dependencies', hydrationMetrics, (hydrationMetrics) => this.discoverExternalViewDependencies(state, refs, ctx, seenRecordKeys, hydrationPass, hydrationMetrics));
+        return trackExternalHydration('dependencies', ctx.xrpcEndpoint, hydrationMetrics, (hydrationMetrics) => this.discoverExternalViewDependencies(state, refs, ctx, seenRecordKeys, hydrationPass, hydrationMetrics));
     }
     async discoverExternalViewDependencies(state, refs, ctx, seenRecordKeys, hydrationPass, hydrationMetrics) {
         // Backlink sources to sample per target, each with its own bound.
         const targets = new Map();
         const discoveredUris = new Set();
+        const rootBatch = !hydrationMetrics.rootsCounted;
+        hydrationMetrics.rootsCounted = true;
         for (const ref of refs) {
             /*
              *  Additional safety in case this method is ever called directly.
@@ -737,6 +740,16 @@ export class Hydrator {
             const record = (cid === undefined
                 ? state.externalRecords?.get(uri)
                 : state.externalRecordsByRef?.get(genericRecordKey({ uri, cid })))?.record;
+            if (rootBatch) {
+                hydrationMetrics.roots += 1;
+                if (record)
+                    hydrationMetrics.rootsResolved += 1;
+            }
+            else {
+                hydrationMetrics.dependencies += 1;
+                if (record)
+                    hydrationMetrics.dependenciesResolved += 1;
+            }
             if (!record)
                 continue;
             const parsed = parseAtUriString(uri);
@@ -807,6 +820,7 @@ export class Hydrator {
                 this.external
                     .getAtmosphereBacklinkCounts([...targets.keys()])
                     .catch((err) => {
+                    hydrationMetrics.partial = true;
                     hydrationLogger.warn({ err }, 'failed to hydrate external record backlink counts');
                     return undefined;
                 }),
@@ -819,6 +833,7 @@ export class Hydrator {
                                 page = await this.external.getAtmosphereBacklinks(uri, collection, { limit });
                             }
                             catch (err) {
+                                hydrationMetrics.partial = true;
                                 hydrationLogger.warn({ err, uri, collection }, 'failed to hydrate external record backlinks');
                                 return;
                             }
@@ -854,6 +869,7 @@ export class Hydrator {
             }
             catch (err) {
                 // Skip the whole batch; partial child state could miss moderation.
+                hydrationMetrics.partial = true;
                 hydrationLogger.warn({ err, hydrationPass, skipped: newUris.length }, 'failed to hydrate external view dependencies');
             }
         }
@@ -1461,6 +1477,7 @@ export class Hydrator {
             includeDebugField,
             // create default anonymous scope
             features: vals.features || this.config.featureGatesClient.scope({}),
+            xrpcEndpoint: vals.xrpcEndpoint,
         });
     }
     async resolveUri(uriStr) {