@atproto/bsky 0.0.221 → 0.0.223

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 { featureGatesLogger } from '../logger'\nimport { FeatureGate } from './gates'\nimport { MetricsClient } from './metrics'\nimport { CheckedFeatureGatesMap, RawUserContext } from './types'\nimport {\n  extractParsedUserContextFromGrowthBookUserContext,\n  parseRawUserContext,\n  parsedUserContextToTrackingMetadata,\n} from './utils'\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\nexport class FeatureGatesClient {\n  ready = false\n  client: GrowthBookClient | undefined = undefined\n  refreshInterval: NodeJS.Timeout | undefined = undefined\n  metrics: MetricsClient\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: (feature, result, userContext) => {\n          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              extractParsedUserContextFromGrowthBookUserContext(userContext),\n            ),\n          )\n        },\n        trackingCallback: (experiment, result, userContext) => {\n          this.metrics.track(\n            'experiment:viewed',\n            {\n              experimentId: experiment.key,\n              variationId: result.key,\n            },\n            parsedUserContextToTrackingMetadata(\n              extractParsedUserContextFromGrowthBookUserContext(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  destroy() {\n    if (this.ready) {\n      this.ready = false\n      if (this.refreshInterval) {\n        clearInterval(this.refreshInterval)\n      }\n    }\n    this.metrics.stop()\n  }\n\n  /**\n   * Evaluate multiple feature gates for a given user, returning a map of gate\n   * ID to boolean result.\n   */\n  checkGates(\n    gates: FeatureGate[],\n    rawUserContext: RawUserContext,\n  ): CheckedFeatureGatesMap {\n    const gb = this.client\n    const attributes = parseRawUserContext(rawUserContext)\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"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/feature-gates/index.ts"],"names":[],"mappings":";;;AAAA,uDAAyD;AAEzD,sCAA8C;AAC9C,mCAAwD;AACxD,uCAAyC;AAMzC,mCAKgB;AAEhB;;;;GAIG;AACH,MAAM,aAAa,GAAG,GAAG,CAAA,CAAC,YAAY;AAEtC;;GAEG;AACH,MAAM,gBAAgB,GAAG,IAAI,CAAA,CAAC,WAAW;AAEzC;;GAEG;AACH,MAAM,0BAA0B,GAAG,kBAAkB,CAAA;AACrD,MAAM,2BAA2B,GAAG,mBAAmB,CAAA;AAIvD,MAAa,kBAAkB;IAY7B,YACU,MAIP;QAJD;;;;mBAAQ,MAAM;WAIb;QAhBK;;;;mBAAQ,KAAK;WAAA;QACb;;;;mBAAuC,SAAS;WAAA;QAChD;;;;mBAA8C,SAAS;WAAA;QACvD;;;;;WAAsB;QAE9B;;;WAGG;QACH;;;;mBAAO,YAAI;WAAA;QAST,IAAI,CAAC,OAAO,GAAG,IAAI,uBAAa,CAAC;YAC/B,gBAAgB,EAAE,MAAM,CAAC,0BAA0B;SACpD,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YACvE,2BAAkB,CAAC,IAAI,CACrB,EAAE,EACF,uDAAuD,CACxD,CAAA;YACD,OAAM;QACR,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,GAAG,IAAI,6BAAgB,CAAC;gBACjC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB;gBACtC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB;gBAC1C,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE;oBAC/C,IAAI,gCAAwB,CAAC,GAAG,CAAC,OAAe,CAAC;wBAAE,OAAM;oBAEzD,IAAI,CAAC,OAAO,CAAC,KAAK,CAChB,gBAAgB,EAChB;wBACE,SAAS,EAAE,OAAO;wBAClB,kBAAkB,EAAE,MAAM,CAAC,KAAK;wBAChC,YAAY,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG;wBACpC,WAAW,EAAE,MAAM,CAAC,gBAAgB,EAAE,GAAG;qBAC1C,EACD,IAAA,2CAAmC,EACjC,IAAA,mDAA2C,EAAC,WAAW,CAAC,CACzD,CACF,CAAA;gBACH,CAAC;gBACD,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE;oBACpD;;;;;uBAKG;oBACH,IACE,MAAM,CAAC,SAAS;wBAChB,gCAAwB,CAAC,GAAG,CAAC,MAAM,CAAC,SAAiB,CAAC;wBAEtD,OAAM;oBAER,IAAI,CAAC,OAAO,CAAC,KAAK,CAChB,mBAAmB,EACnB;wBACE,YAAY,EAAE,UAAU,CAAC,GAAG;wBAC5B,WAAW,EAAE,MAAM,CAAC,GAAG;qBACxB,EACD,IAAA,2CAAmC,EACjC,IAAA,mDAA2C,EAAC,WAAW,CAAC,CACzD,CACF,CAAA;gBACH,CAAC;aACF,CAAC,CAAA;YAEF,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBAC/C,OAAO,EAAE,aAAa;aACvB,CAAC,CAAA;YAEF;;;;;;eAMG;YACH,IAAI,KAAK,EAAE,CAAC;gBACV,2BAAkB,CAAC,KAAK,CACtB,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EACtB,sCAAsC,CACvC,CAAA;YACH,CAAC;YAED;;;;eAIG;YACH,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;gBAC5C,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC;wBACjC,OAAO,EAAE,aAAa;qBACvB,CAAC,CAAA;gBACJ,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,2BAAkB,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,4BAA4B,CAAC,CAAA;gBACjE,CAAC;YACH,CAAC,EAAE,gBAAgB,CAAC,CAAA;YAEpB,gCAAgC;YAChC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,2BAAkB,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,8BAA8B,CAAC,CAAA;QACnE,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;YAClB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACzB,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;YACrC,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;IACrB,CAAC;IAED;;;OAGG;IACK,UAAU,CAChB,KAAa,EACb,WAAwB;QAExB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAA;QACtB,MAAM,UAAU,GAAG,IAAA,4BAAoB,EAAC,WAAW,CAAC,CAAA;QACpD,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;QACpE,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACnE,CAAC;IAED,KAAK,CAAC,iBAA8B;QAClC;;;WAGG;QACH,MAAM,IAAI,GAAG,IAAA,4BAAoB,EAAC,iBAAiB,CAAC,CAAA;QACpD,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,CACV,KAAa,EACb,oBAA+C,EAC/C,EAAE;gBACF,MAAM,WAAW,GAAG,IAAA,yBAAiB,EAAC,IAAI,EAAE,oBAAoB,CAAC,CAAA;gBACjE,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;YAC5C,CAAC;YACD,SAAS,EAAE,CAAC,IAAU,EAAE,oBAAkC,EAAE,EAAE;gBAC5D,MAAM,WAAW,GAAG,IAAA,yBAAiB,EAAC,IAAI,EAAE,oBAAoB,CAAC,CAAA;gBACjE,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAA;YAChE,CAAC;SACF,CAAA;IACH,CAAC;IAED;;;;;OAKG;IACH,2BAA2B,CAAC,EAC1B,MAAM,EACN,GAAG,GAUJ;QACC,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAA;QACvD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAA;QAEzD,OAAO,IAAA,4BAAoB,EAAC;YAC1B,GAAG,EAAE,MAAM;YACX,QAAQ;YACR,SAAS;SACV,CAAC,CAAA;IACJ,CAAC;CACF;AAjMD,gDAiMC","sourcesContent":["import { GrowthBookClient } from '@growthbook/growthbook'\nimport type express from 'express'\nimport { featureGatesLogger } from '../logger'\nimport { Gate, IGNORE_METRICS_FOR_GATES } from './gates'\nimport { MetricsClient } from './metrics'\nimport {\n  CheckedFeatureGatesMap,\n  ScopedFeatureGatesClient,\n  UserContext,\n} from './types'\nimport {\n  extractUserContextFromGrowthbookUserContext,\n  mergeUserContexts,\n  normalizeUserContext,\n  parsedUserContextToTrackingMetadata,\n} from './utils'\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-Bsky-Device-Id'\nconst ANALYTICS_HEADER_SESSION_ID = 'X-Bsky-Session-Id'\n\nexport { type ScopedFeatureGatesClient } from './types'\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: (feature, result, userContext) => {\n          if (IGNORE_METRICS_FOR_GATES.has(feature as Gate)) return\n\n          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: (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          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  destroy() {\n    if (this.ready) {\n      this.ready = false\n      if (this.refreshInterval) {\n        clearInterval(this.refreshInterval)\n      }\n    }\n    this.metrics.stop()\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/feature-gates/types.d.ts

@@ -1,27 +1,20 @@
-import type express from 'express';
-import { FeatureGate } from './gates';
+import { Gate } from './gates';
 /**
  * The user context passed to the feature gates client for evaluation and
  * tracking purposes.
  */
-export type RawUserContext = {
-    /**
-     * The user's DID
-     */
-    viewer: string | null;
-    /**
-     * The express request object, used to extract analytics headers for the user context
-     */
-    req?: express.Request;
+export type UserContext = {
+    did?: string | null;
+    deviceId?: string | null;
+    sessionId?: string | null;
 };
 /**
- * Extracted values from the `RawUserContext`. These values should match the
- * `attributes` we've configured for GrowthBook in our GB dashboard. We also
- * send these same values as properties in our analytics events, so we want to
- * make sure they are consistent.
+ * User context that has been normalized to ensure all required properties are
+ * present and have fallback values. This is the format that we expect to use
+ * for all feature gate evaluations and analytics tracking.
  */
-export type ParsedUserContext = {
-    did?: string | null;
+export type NormalizedUserContext = {
+    did?: string;
     deviceId: string;
     sessionId: string;
 };
@@ -45,5 +38,18 @@ export type TrackingMetadata = {
  * Pre-evaluated feature gates map, the result of
  * `ctx.FeatureGatesClient.checkGates()`
  */
-export type CheckedFeatureGatesMap = Map<FeatureGate, boolean>;
+export type CheckedFeatureGatesMap = Map<Gate, boolean>;
+/**
+ * The primary interface for interacting with feature gates in the system. This
+ * client is designed to be used in the context of an XRPC handler, where we
+ * can parse the user context from the request and then create a scoped client
+ * for that request lifecycle. The client provides methods for checking multiple
+ * gates at once, as well as checking individual gates with optional user
+ * context overrides.
+ */
+export type ScopedFeatureGatesClient = {
+    Gate: typeof Gate;
+    checkGates(gates: Gate[], userContextOverrides?: UserContext): CheckedFeatureGatesMap;
+    checkGate(gate: Gate, userContextOverrides?: UserContext): boolean;
+};
 //# sourceMappingURL=types.d.ts.map

package/dist/feature-gates/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/feature-gates/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAErC;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB;;OAEG;IAEH,GAAG,CAAC,EAAE,OAAO,CAAC,OAAO,CAAA;CACtB,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;KACxB,CAAA;CACF,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/feature-gates/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAE9B;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;KACxB,CAAA;CACF,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AAEvD;;;;;;;GAOG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,OAAO,IAAI,CAAA;IACjB,UAAU,CACR,KAAK,EAAE,IAAI,EAAE,EACb,oBAAoB,CAAC,EAAE,WAAW,GACjC,sBAAsB,CAAA;IACzB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,oBAAoB,CAAC,EAAE,WAAW,GAAG,OAAO,CAAA;CACnE,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/feature-gates/types.ts"],"names":[],"mappings":"","sourcesContent":["import type express from 'express'\nimport { FeatureGate } from './gates'\n\n/**\n * The user context passed to the feature gates client for evaluation and\n * tracking purposes.\n */\nexport type RawUserContext = {\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  // TODO: remove optional after image migration.\n  req?: express.Request\n}\n\n/**\n * Extracted values from the `RawUserContext`. These values should match the\n * `attributes` we've configured for GrowthBook in our GB dashboard. We also\n * send these same values as properties in our analytics events, so we want to\n * make sure they are consistent.\n */\nexport type ParsedUserContext = {\n  did?: string | null\n  deviceId: string\n  sessionId: string\n}\n\n/**\n * This loosely matches the metadata we send from the client for analytics\n * events. We want to make sure we have the same properties in both places so\n * that we can correlate feature gate evaluations with analytics events.\n *\n * @see https://github.com/bluesky-social/social-app/blob/76109a58dc7aafccdfbd07a81cbd9925e065d1c0/src/analytics/metadata.ts\n */\nexport type TrackingMetadata = {\n  base: {\n    deviceId: string\n    sessionId: string\n  }\n  session: {\n    did: string | undefined\n  }\n}\n\n/**\n * Pre-evaluated feature gates map, the result of\n * `ctx.FeatureGatesClient.checkGates()`\n */\nexport type CheckedFeatureGatesMap = Map<FeatureGate, boolean>\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/feature-gates/types.ts"],"names":[],"mappings":"","sourcesContent":["import { Gate } from './gates'\n\n/**\n * The user context passed to the feature gates client for evaluation and\n * tracking purposes.\n */\nexport type UserContext = {\n  did?: string | null\n  deviceId?: string | null\n  sessionId?: string | null\n}\n\n/**\n * User context that has been normalized to ensure all required properties are\n * present and have fallback values. This is the format that we expect to use\n * for all feature gate evaluations and analytics tracking.\n */\nexport type NormalizedUserContext = {\n  did?: string\n  deviceId: string\n  sessionId: string\n}\n\n/**\n * This loosely matches the metadata we send from the client for analytics\n * events. We want to make sure we have the same properties in both places so\n * that we can correlate feature gate evaluations with analytics events.\n *\n * @see https://github.com/bluesky-social/social-app/blob/76109a58dc7aafccdfbd07a81cbd9925e065d1c0/src/analytics/metadata.ts\n */\nexport type TrackingMetadata = {\n  base: {\n    deviceId: string\n    sessionId: string\n  }\n  session: {\n    did: string | undefined\n  }\n}\n\n/**\n * Pre-evaluated feature gates map, the result of\n * `ctx.FeatureGatesClient.checkGates()`\n */\nexport type CheckedFeatureGatesMap = Map<Gate, boolean>\n\n/**\n * The primary interface for interacting with feature gates in the system. This\n * client is designed to be used in the context of an XRPC handler, where we\n * can parse the user context from the request and then create a scoped client\n * for that request lifecycle. The client provides methods for checking multiple\n * gates at once, as well as checking individual gates with optional user\n * context overrides.\n */\nexport type ScopedFeatureGatesClient = {\n  Gate: typeof Gate\n  checkGates(\n    gates: Gate[],\n    userContextOverrides?: UserContext,\n  ): CheckedFeatureGatesMap\n  checkGate(gate: Gate, userContextOverrides?: UserContext): boolean\n}\n"]}

package/dist/feature-gates/utils.d.ts

@@ -1,21 +1,21 @@
 import { type UserContext as GrowthBookUserContext } from '@growthbook/growthbook';
-import { ParsedUserContext, RawUserContext, TrackingMetadata } from './types';
+import { NormalizedUserContext, TrackingMetadata, UserContext } from './types';
+export declare function normalizeUserContext(userContext: UserContext): NormalizedUserContext;
 /**
- * Parse the `RawUserContext` into a `ParsedUserContext` that is used as
- * GrowthBook `attributes` as well as the metadata payload for our analytics
- * events. This ensures that the same user properties are used for both feature
- * gate targeting and analytics.
+ * Merge the base user context with any overrides provided at check time. This
+ * allows us to set a base context for the request, but also override or add
+ * properties for specific gate checks if needed.
  */
-export declare function parseRawUserContext(userContext: RawUserContext): ParsedUserContext;
+export declare function mergeUserContexts(base: NormalizedUserContext, overrides?: UserContext): NormalizedUserContext;
 /**
- * Extract the `ParsedUserContext` from the GrowthBook `UserContext`, which we
+ * Extract the `UserContext` from GrowthBook's own `UserContext`, which we
  * passed into `isOn` as `attributes`.
  */
-export declare function extractParsedUserContextFromGrowthBookUserContext(userContext: GrowthBookUserContext): ParsedUserContext;
+export declare function extractUserContextFromGrowthbookUserContext(userContext: GrowthBookUserContext): NormalizedUserContext;
 /**
- * Convert the `ParsedUserContext` into the `TrackingMetadata` format that we
+ * Convert the `UserContext` into the `TrackingMetadata` format that we
  * use for our analytics events. This ensures that we have the same user
  * properties as we do for events from our client app.
  */
-export declare function parsedUserContextToTrackingMetadata(parsedUserContext: ParsedUserContext): TrackingMetadata;
+export declare function parsedUserContextToTrackingMetadata(userContext: NormalizedUserContext): TrackingMetadata;
 //# sourceMappingURL=utils.d.ts.map

package/dist/feature-gates/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/feature-gates/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,IAAI,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAClF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAQ7E;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,cAAc,GAC1B,iBAAiB,CAwCnB;AAED;;;GAGG;AACH,wBAAgB,iDAAiD,CAC/D,WAAW,EAAE,qBAAqB,GACjC,iBAAiB,CAMnB;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,iBAAiB,EAAE,iBAAiB,GACnC,gBAAgB,CAUlB"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/feature-gates/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,IAAI,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAClF,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE9E,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,WAAW,GACvB,qBAAqB,CA+BvB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,qBAAqB,EAC3B,SAAS,CAAC,EAAE,WAAW,GACtB,qBAAqB,CA4CvB;AAED;;;GAGG;AACH,wBAAgB,2CAA2C,CACzD,WAAW,EAAE,qBAAqB,GACjC,qBAAqB,CAYvB;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,qBAAqB,GACjC,gBAAgB,CAUlB"}

package/dist/feature-gates/utils.js

@@ -3,52 +3,32 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseRawUserContext = parseRawUserContext;
-exports.extractParsedUserContextFromGrowthBookUserContext = extractParsedUserContextFromGrowthBookUserContext;
+exports.normalizeUserContext = normalizeUserContext;
+exports.mergeUserContexts = mergeUserContexts;
+exports.extractUserContextFromGrowthbookUserContext = extractUserContextFromGrowthbookUserContext;
 exports.parsedUserContextToTrackingMetadata = parsedUserContextToTrackingMetadata;
 const node_crypto_1 = __importDefault(require("node:crypto"));
-/**
- * These need to match what the client sends
- */
-const ANALYTICS_HEADER_DEVICE_ID = 'X-Bsky-Device-Id';
-const ANALYTICS_HEADER_SESSION_ID = 'X-Bsky-Session-Id';
-/**
- * Parse the `RawUserContext` into a `ParsedUserContext` that is used as
- * GrowthBook `attributes` as well as the metadata payload for our analytics
- * events. This ensures that the same user properties are used for both feature
- * gate targeting and analytics.
- */
-function parseRawUserContext(userContext) {
-    const did = userContext.viewer;
-    // prioritize passthrough header
-    // TODO: remove optional after image rollout.
-    let deviceId = userContext.req?.header(ANALYTICS_HEADER_DEVICE_ID);
+function normalizeUserContext(userContext) {
+    const did = userContext.did ?? undefined;
+    let deviceId = userContext.deviceId;
+    let sessionId = userContext.sessionId;
     if (!deviceId) {
-        if (did) {
-            /*
-             * If we don't have a device header, fall back to the DID. Our event
-             * proxy ensures ordering based on this deviceId (also called a stableId
-             * in the proxy), so if we have a DID, we want to use it to ensure client
-             * and server events are properly ordered.
-             */
-            deviceId = did;
-        }
-        else {
-            /*
-             * Without any better option for identifying the user, we generate a
-             * random deviceId.
-             */
-            deviceId = `anon-${node_crypto_1.default.randomUUID()}`;
-        }
-    }
-    // prioritize passthrough header
-    // TODO: remove optional after image rollout.
-    let sessionId = userContext.req?.header(ANALYTICS_HEADER_SESSION_ID);
-    if (!sessionId) {
         /*
+         * If we don't have a deviceId by other means, such as a request header,
+         * fall back to the DID. Our event proxy ensures ordering based on this
+         * deviceId (also called a stableId in the proxy), so if we have a DID, we
+         * want to use it to ensure client and server events are properly ordered.
+         *
          * Without any better option for identifying the user, we generate a
          * random deviceId.
          */
+        deviceId = did ?? `anon-${node_crypto_1.default.randomUUID()}`;
+    }
+    if (!sessionId) {
+        /*
+         * If we don't have a sessionId by other means, such as a request header,
+         * generate a random sessionId.
+         */
         sessionId = `anon-${node_crypto_1.default.randomUUID()}`;
     }
     return {
@@ -58,29 +38,82 @@ function parseRawUserContext(userContext) {
     };
 }
 /**
- * Extract the `ParsedUserContext` from the GrowthBook `UserContext`, which we
- * passed into `isOn` as `attributes`.
+ * Merge the base user context with any overrides provided at check time. This
+ * allows us to set a base context for the request, but also override or add
+ * properties for specific gate checks if needed.
  */
-function extractParsedUserContextFromGrowthBookUserContext(userContext) {
+function mergeUserContexts(base, overrides) {
+    const did = overrides?.did ?? base.did ?? undefined;
+    let deviceId = overrides?.deviceId ?? base.deviceId;
+    let sessionId = overrides?.sessionId ?? base.sessionId;
+    let isDifferentDid = false;
+    if (did && deviceId.startsWith('anon-')) {
+        /*
+         * If we have a DID, but the existing deviceId is anonymous, use the DID as
+         * the deviceId to ensure proper ordering of events in our event proxy.
+         * This matches the logic in `normalizeUserContext` where we fall back to
+         * the DID for the deviceId if we don't have a deviceId from other means.
+         */
+        deviceId = did;
+    }
+    else if (did && deviceId !== did) {
+        /*
+         * If we have both a DID and a deviceId, but they don't match, we may be
+         * overriding context to check a feature that is independent of a single
+         * request handler lifecycle.
+         *
+         * Example: a ScopedFeatureGatesClient was created in the root request
+         * handler with a user context that has a DID, but later on in the request
+         * lifecycle we may check a gate using the DID of the author of the image
+         * we're returning as part of the response.
+         */
+        deviceId = did;
+        isDifferentDid = true;
+    }
+    if (isDifferentDid) {
+        /*
+         * If we're merging in a different DID, we should also generate a new
+         * sessionId to avoid mixing events from different users under the same
+         * session.
+         */
+        sessionId = `anon-${node_crypto_1.default.randomUUID()}`;
+    }
     return {
+        did,
+        deviceId,
+        sessionId,
+    };
+}
+/**
+ * Extract the `UserContext` from GrowthBook's own `UserContext`, which we
+ * passed into `isOn` as `attributes`.
+ */
+function extractUserContextFromGrowthbookUserContext(userContext) {
+    /*
+     * The values passed to Growthbook already should have been
+     * `NormalizedUserContext`, but for type safety we run them through the
+     * normalizer again to ensure we have all the required properties and
+     * fallbacks in place.
+     */
+    return normalizeUserContext({
         did: userContext.attributes?.did,
         deviceId: userContext.attributes?.deviceId,
         sessionId: userContext.attributes?.sessionId,
-    };
+    });
 }
 /**
- * Convert the `ParsedUserContext` into the `TrackingMetadata` format that we
+ * Convert the `UserContext` into the `TrackingMetadata` format that we
  * use for our analytics events. This ensures that we have the same user
  * properties as we do for events from our client app.
  */
-function parsedUserContextToTrackingMetadata(parsedUserContext) {
+function parsedUserContextToTrackingMetadata(userContext) {
     return {
         base: {
-            deviceId: parsedUserContext.deviceId,
-            sessionId: parsedUserContext.sessionId,
+            deviceId: userContext.deviceId,
+            sessionId: userContext.sessionId,
         },
         session: {
-            did: parsedUserContext.did ?? undefined,
+            did: userContext.did ?? undefined,
         },
     };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/feature-gates/utils.ts"],"names":[],"mappings":";;;;;AAgBA,kDA0CC;AAMD,8GAQC;AAOD,kFAYC;AA3FD,8DAAgC;AAIhC;;GAEG;AACH,MAAM,0BAA0B,GAAG,kBAAkB,CAAA;AACrD,MAAM,2BAA2B,GAAG,mBAAmB,CAAA;AAEvD;;;;;GAKG;AACH,SAAgB,mBAAmB,CACjC,WAA2B;IAE3B,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAA;IAE9B,gCAAgC;IAChC,6CAA6C;IAC7C,IAAI,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,0BAA0B,CAAC,CAAA;IAClE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,IAAI,GAAG,EAAE,CAAC;YACR;;;;;eAKG;YACH,QAAQ,GAAG,GAAG,CAAA;QAChB,CAAC;aAAM,CAAC;YACN;;;eAGG;YACH,QAAQ,GAAG,QAAQ,qBAAM,CAAC,UAAU,EAAE,EAAE,CAAA;QAC1C,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,6CAA6C;IAC7C,IAAI,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,2BAA2B,CAAC,CAAA;IACpE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf;;;WAGG;QACH,SAAS,GAAG,QAAQ,qBAAM,CAAC,UAAU,EAAE,EAAE,CAAA;IAC3C,CAAC;IAED,OAAO;QACL,GAAG;QACH,QAAQ;QACR,SAAS;KACV,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,iDAAiD,CAC/D,WAAkC;IAElC,OAAO;QACL,GAAG,EAAE,WAAW,CAAC,UAAU,EAAE,GAAG;QAChC,QAAQ,EAAE,WAAW,CAAC,UAAU,EAAE,QAAQ;QAC1C,SAAS,EAAE,WAAW,CAAC,UAAU,EAAE,SAAS;KAC7C,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,mCAAmC,CACjD,iBAAoC;IAEpC,OAAO;QACL,IAAI,EAAE;YACJ,QAAQ,EAAE,iBAAiB,CAAC,QAAQ;YACpC,SAAS,EAAE,iBAAiB,CAAC,SAAS;SACvC;QACD,OAAO,EAAE;YACP,GAAG,EAAE,iBAAiB,CAAC,GAAG,IAAI,SAAS;SACxC;KACF,CAAA;AACH,CAAC","sourcesContent":["import crypto from 'node:crypto'\nimport { type UserContext as GrowthBookUserContext } from '@growthbook/growthbook'\nimport { ParsedUserContext, RawUserContext, TrackingMetadata } from './types'\n\n/**\n * These need to match what the client sends\n */\nconst ANALYTICS_HEADER_DEVICE_ID = 'X-Bsky-Device-Id'\nconst ANALYTICS_HEADER_SESSION_ID = 'X-Bsky-Session-Id'\n\n/**\n * Parse the `RawUserContext` into a `ParsedUserContext` that is used as\n * GrowthBook `attributes` as well as the metadata payload for our analytics\n * events. This ensures that the same user properties are used for both feature\n * gate targeting and analytics.\n */\nexport function parseRawUserContext(\n  userContext: RawUserContext,\n): ParsedUserContext {\n  const did = userContext.viewer\n\n  // prioritize passthrough header\n  // TODO: remove optional after image rollout.\n  let deviceId = userContext.req?.header(ANALYTICS_HEADER_DEVICE_ID)\n  if (!deviceId) {\n    if (did) {\n      /*\n       * If we don't have a device header, fall back to the DID. Our event\n       * proxy ensures ordering based on this deviceId (also called a stableId\n       * in the proxy), so if we have a DID, we want to use it to ensure client\n       * and server events are properly ordered.\n       */\n      deviceId = did\n    } else {\n      /*\n       * Without any better option for identifying the user, we generate a\n       * random deviceId.\n       */\n      deviceId = `anon-${crypto.randomUUID()}`\n    }\n  }\n\n  // prioritize passthrough header\n  // TODO: remove optional after image rollout.\n  let sessionId = userContext.req?.header(ANALYTICS_HEADER_SESSION_ID)\n  if (!sessionId) {\n    /*\n     * Without any better option for identifying the user, we generate a\n     * random deviceId.\n     */\n    sessionId = `anon-${crypto.randomUUID()}`\n  }\n\n  return {\n    did,\n    deviceId,\n    sessionId,\n  }\n}\n\n/**\n * Extract the `ParsedUserContext` from the GrowthBook `UserContext`, which we\n * passed into `isOn` as `attributes`.\n */\nexport function extractParsedUserContextFromGrowthBookUserContext(\n  userContext: GrowthBookUserContext,\n): ParsedUserContext {\n  return {\n    did: userContext.attributes?.did,\n    deviceId: userContext.attributes?.deviceId,\n    sessionId: userContext.attributes?.sessionId,\n  }\n}\n\n/**\n * Convert the `ParsedUserContext` into the `TrackingMetadata` format that we\n * use for our analytics events. This ensures that we have the same user\n * properties as we do for events from our client app.\n */\nexport function parsedUserContextToTrackingMetadata(\n  parsedUserContext: ParsedUserContext,\n): TrackingMetadata {\n  return {\n    base: {\n      deviceId: parsedUserContext.deviceId,\n      sessionId: parsedUserContext.sessionId,\n    },\n    session: {\n      did: parsedUserContext.did ?? undefined,\n    },\n  }\n}\n"]}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/feature-gates/utils.ts"],"names":[],"mappings":";;;;;AAIA,oDAiCC;AAOD,8CA+CC;AAMD,kGAcC;AAOD,kFAYC;AAlID,8DAAgC;AAIhC,SAAgB,oBAAoB,CAClC,WAAwB;IAExB,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,IAAI,SAAS,CAAA;IACxC,IAAI,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAA;IACnC,IAAI,SAAS,GAAG,WAAW,CAAC,SAAS,CAAA;IAErC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd;;;;;;;;WAQG;QACH,QAAQ,GAAG,GAAG,IAAI,QAAQ,qBAAM,CAAC,UAAU,EAAE,EAAE,CAAA;IACjD,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf;;;WAGG;QACH,SAAS,GAAG,QAAQ,qBAAM,CAAC,UAAU,EAAE,EAAE,CAAA;IAC3C,CAAC;IAED,OAAO;QACL,GAAG;QACH,QAAQ;QACR,SAAS;KACV,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAC/B,IAA2B,EAC3B,SAAuB;IAEvB,MAAM,GAAG,GAAG,SAAS,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,SAAS,CAAA;IACnD,IAAI,QAAQ,GAAG,SAAS,EAAE,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAA;IACnD,IAAI,SAAS,GAAG,SAAS,EAAE,SAAS,IAAI,IAAI,CAAC,SAAS,CAAA;IAEtD,IAAI,cAAc,GAAG,KAAK,CAAA;IAE1B,IAAI,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC;;;;;WAKG;QACH,QAAQ,GAAG,GAAG,CAAA;IAChB,CAAC;SAAM,IAAI,GAAG,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;QACnC;;;;;;;;;WASG;QACH,QAAQ,GAAG,GAAG,CAAA;QACd,cAAc,GAAG,IAAI,CAAA;IACvB,CAAC;IAED,IAAI,cAAc,EAAE,CAAC;QACnB;;;;WAIG;QACH,SAAS,GAAG,QAAQ,qBAAM,CAAC,UAAU,EAAE,EAAE,CAAA;IAC3C,CAAC;IAED,OAAO;QACL,GAAG;QACH,QAAQ;QACR,SAAS;KACV,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,2CAA2C,CACzD,WAAkC;IAElC;;;;;OAKG;IACH,OAAO,oBAAoB,CAAC;QAC1B,GAAG,EAAE,WAAW,CAAC,UAAU,EAAE,GAAG;QAChC,QAAQ,EAAE,WAAW,CAAC,UAAU,EAAE,QAAQ;QAC1C,SAAS,EAAE,WAAW,CAAC,UAAU,EAAE,SAAS;KAC7C,CAAC,CAAA;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,mCAAmC,CACjD,WAAkC;IAElC,OAAO;QACL,IAAI,EAAE;YACJ,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,SAAS,EAAE,WAAW,CAAC,SAAS;SACjC;QACD,OAAO,EAAE;YACP,GAAG,EAAE,WAAW,CAAC,GAAG,IAAI,SAAS;SAClC;KACF,CAAA;AACH,CAAC","sourcesContent":["import crypto from 'node:crypto'\nimport { type UserContext as GrowthBookUserContext } from '@growthbook/growthbook'\nimport { NormalizedUserContext, TrackingMetadata, UserContext } from './types'\n\nexport function normalizeUserContext(\n  userContext: UserContext,\n): NormalizedUserContext {\n  const did = userContext.did ?? undefined\n  let deviceId = userContext.deviceId\n  let sessionId = userContext.sessionId\n\n  if (!deviceId) {\n    /*\n     * If we don't have a deviceId by other means, such as a request header,\n     * fall back to the DID. Our event proxy ensures ordering based on this\n     * deviceId (also called a stableId in the proxy), so if we have a DID, we\n     * want to use it to ensure client and server events are properly ordered.\n     *\n     * Without any better option for identifying the user, we generate a\n     * random deviceId.\n     */\n    deviceId = did ?? `anon-${crypto.randomUUID()}`\n  }\n\n  if (!sessionId) {\n    /*\n     * If we don't have a sessionId by other means, such as a request header,\n     * generate a random sessionId.\n     */\n    sessionId = `anon-${crypto.randomUUID()}`\n  }\n\n  return {\n    did,\n    deviceId,\n    sessionId,\n  }\n}\n\n/**\n * Merge the base user context with any overrides provided at check time. This\n * allows us to set a base context for the request, but also override or add\n * properties for specific gate checks if needed.\n */\nexport function mergeUserContexts(\n  base: NormalizedUserContext,\n  overrides?: UserContext,\n): NormalizedUserContext {\n  const did = overrides?.did ?? base.did ?? undefined\n  let deviceId = overrides?.deviceId ?? base.deviceId\n  let sessionId = overrides?.sessionId ?? base.sessionId\n\n  let isDifferentDid = false\n\n  if (did && deviceId.startsWith('anon-')) {\n    /*\n     * If we have a DID, but the existing deviceId is anonymous, use the DID as\n     * the deviceId to ensure proper ordering of events in our event proxy.\n     * This matches the logic in `normalizeUserContext` where we fall back to\n     * the DID for the deviceId if we don't have a deviceId from other means.\n     */\n    deviceId = did\n  } else if (did && deviceId !== did) {\n    /*\n     * If we have both a DID and a deviceId, but they don't match, we may be\n     * overriding context to check a feature that is independent of a single\n     * request handler lifecycle.\n     *\n     * Example: a ScopedFeatureGatesClient was created in the root request\n     * handler with a user context that has a DID, but later on in the request\n     * lifecycle we may check a gate using the DID of the author of the image\n     * we're returning as part of the response.\n     */\n    deviceId = did\n    isDifferentDid = true\n  }\n\n  if (isDifferentDid) {\n    /*\n     * If we're merging in a different DID, we should also generate a new\n     * sessionId to avoid mixing events from different users under the same\n     * session.\n     */\n    sessionId = `anon-${crypto.randomUUID()}`\n  }\n\n  return {\n    did,\n    deviceId,\n    sessionId,\n  }\n}\n\n/**\n * Extract the `UserContext` from GrowthBook's own `UserContext`, which we\n * passed into `isOn` as `attributes`.\n */\nexport function extractUserContextFromGrowthbookUserContext(\n  userContext: GrowthBookUserContext,\n): NormalizedUserContext {\n  /*\n   * The values passed to Growthbook already should have been\n   * `NormalizedUserContext`, but for type safety we run them through the\n   * normalizer again to ensure we have all the required properties and\n   * fallbacks in place.\n   */\n  return normalizeUserContext({\n    did: userContext.attributes?.did,\n    deviceId: userContext.attributes?.deviceId,\n    sessionId: userContext.attributes?.sessionId,\n  })\n}\n\n/**\n * Convert the `UserContext` into the `TrackingMetadata` format that we\n * use for our analytics events. This ensures that we have the same user\n * properties as we do for events from our client app.\n */\nexport function parsedUserContextToTrackingMetadata(\n  userContext: NormalizedUserContext,\n): TrackingMetadata {\n  return {\n    base: {\n      deviceId: userContext.deviceId,\n      sessionId: userContext.sessionId,\n    },\n    session: {\n      did: userContext.did ?? undefined,\n    },\n  }\n}\n"]}

package/dist/feature-gates/utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=utils.test.d.ts.map

package/dist/feature-gates/utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.test.d.ts","sourceRoot":"","sources":["../../src/feature-gates/utils.test.ts"],"names":[],"mappings":""}

package/dist/feature-gates/utils.test.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/// <reference types="jest" />
+const utils_1 = require("./utils");
+describe('normalizeUserContext', () => {
+    it('defaults', () => {
+        const ctx = (0, utils_1.normalizeUserContext)({});
+        expect(ctx.did).toBeUndefined();
+        expect(ctx.deviceId).toMatch(/^anon-/);
+        expect(ctx.sessionId).toMatch(/^anon-/);
+    });
+    it('with did', () => {
+        const ctx = (0, utils_1.normalizeUserContext)({
+            did: 'did:example:123',
+        });
+        expect(ctx.did).toBe('did:example:123');
+        expect(ctx.deviceId).toBe('did:example:123');
+        expect(ctx.sessionId).toMatch(/^anon-/);
+    });
+    it('with did and deviceId', () => {
+        const ctx = (0, utils_1.normalizeUserContext)({
+            did: 'did:example:123',
+            deviceId: 'device-456',
+        });
+        expect(ctx.did).toBe('did:example:123');
+        expect(ctx.deviceId).toBe('device-456');
+        expect(ctx.sessionId).toMatch(/^anon-/);
+    });
+    it('with only deviceId and sessionId', () => {
+        const ctx = (0, utils_1.normalizeUserContext)({
+            deviceId: 'device-456',
+            sessionId: 'session-789',
+        });
+        expect(ctx.did).toBeUndefined();
+        expect(ctx.deviceId).toBe('device-456');
+        expect(ctx.sessionId).toBe('session-789');
+    });
+});
+describe('mergeUserContexts', () => {
+    it('anonymous base context, override with did', () => {
+        const base = (0, utils_1.normalizeUserContext)({});
+        const merged = (0, utils_1.mergeUserContexts)(base, { did: 'did:example:123' });
+        expect(merged.did).toBe('did:example:123');
+        expect(merged.deviceId).toBe('did:example:123');
+        expect(merged.sessionId).toBe(base.sessionId);
+    });
+    it('base context with did, override with different did', () => {
+        const base = (0, utils_1.normalizeUserContext)({ did: 'did:example:123' });
+        const merged = (0, utils_1.mergeUserContexts)(base, { did: 'did:example:456' });
+        expect(merged.did).toBe('did:example:456');
+        expect(merged.deviceId).toBe('did:example:456');
+        expect(merged.sessionId).toMatch(/^anon-/);
+    });
+    it('base context with did, override with same did', () => {
+        const base = (0, utils_1.normalizeUserContext)({ did: 'did:example:123' });
+        const merged = (0, utils_1.mergeUserContexts)(base, { did: 'did:example:123' });
+        expect(merged.did).toBe('did:example:123');
+        expect(merged.deviceId).toBe('did:example:123');
+        expect(merged.sessionId).toBe(base.sessionId);
+    });
+});
+//# sourceMappingURL=utils.test.js.map

package/dist/feature-gates/utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.test.js","sourceRoot":"","sources":["../../src/feature-gates/utils.test.ts"],"names":[],"mappings":"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","sourcesContent":["/// <reference types=\"jest\" />\nimport { mergeUserContexts, normalizeUserContext } from './utils'\n\ndescribe('normalizeUserContext', () => {\n  it('defaults', () => {\n    const ctx = normalizeUserContext({})\n    expect(ctx.did).toBeUndefined()\n    expect(ctx.deviceId).toMatch(/^anon-/)\n    expect(ctx.sessionId).toMatch(/^anon-/)\n  })\n\n  it('with did', () => {\n    const ctx = normalizeUserContext({\n      did: 'did:example:123',\n    })\n    expect(ctx.did).toBe('did:example:123')\n    expect(ctx.deviceId).toBe('did:example:123')\n    expect(ctx.sessionId).toMatch(/^anon-/)\n  })\n\n  it('with did and deviceId', () => {\n    const ctx = normalizeUserContext({\n      did: 'did:example:123',\n      deviceId: 'device-456',\n    })\n    expect(ctx.did).toBe('did:example:123')\n    expect(ctx.deviceId).toBe('device-456')\n    expect(ctx.sessionId).toMatch(/^anon-/)\n  })\n\n  it('with only deviceId and sessionId', () => {\n    const ctx = normalizeUserContext({\n      deviceId: 'device-456',\n      sessionId: 'session-789',\n    })\n    expect(ctx.did).toBeUndefined()\n    expect(ctx.deviceId).toBe('device-456')\n    expect(ctx.sessionId).toBe('session-789')\n  })\n})\n\ndescribe('mergeUserContexts', () => {\n  it('anonymous base context, override with did', () => {\n    const base = normalizeUserContext({})\n    const merged = mergeUserContexts(base, { did: 'did:example:123' })\n    expect(merged.did).toBe('did:example:123')\n    expect(merged.deviceId).toBe('did:example:123')\n    expect(merged.sessionId).toBe(base.sessionId)\n  })\n\n  it('base context with did, override with different did', () => {\n    const base = normalizeUserContext({ did: 'did:example:123' })\n    const merged = mergeUserContexts(base, { did: 'did:example:456' })\n    expect(merged.did).toBe('did:example:456')\n    expect(merged.deviceId).toBe('did:example:456')\n    expect(merged.sessionId).toMatch(/^anon-/)\n  })\n\n  it('base context with did, override with same did', () => {\n    const base = normalizeUserContext({ did: 'did:example:123' })\n    const merged = mergeUserContexts(base, { did: 'did:example:123' })\n    expect(merged.did).toBe('did:example:123')\n    expect(merged.deviceId).toBe('did:example:123')\n    expect(merged.sessionId).toBe(base.sessionId)\n  })\n})\n"]}

package/dist/hydration/actor.d.ts

@@ -1,16 +1,13 @@
-import { AppBskyNotificationDeclaration } from '@atproto/api';
+import { AtIdentifierString, AtUriString, DatetimeString, DidString, HandleString } from '@atproto/syntax';
 import { DataPlaneClient } from '../data-plane/client';
-import { Record as ProfileRecord } from '../lexicon/types/app/bsky/actor/profile';
-import { Record as StatusRecord } from '../lexicon/types/app/bsky/actor/status';
-import { Record as NotificationDeclarationRecord } from '../lexicon/types/app/bsky/notification/declaration';
-import { Record as ChatDeclarationRecord } from '../lexicon/types/chat/bsky/actor/declaration';
-import { Record as GermDeclarationRecord } from '../lexicon/types/com/germnetwork/declaration';
+import { app } from '../lexicons/index.js';
 import { VerificationMeta } from '../proto/bsky_pb';
+import { ChatDeclarationRecord, GermDeclarationRecord, NotificationDeclarationRecord, ProfileRecord, StatusRecord } from '../views/types.js';
 import { HydrationMap, RecordInfo } from './util';
-type AllowActivitySubscriptions = Extract<AppBskyNotificationDeclaration.Record['allowSubscriptions'], 'followers' | 'mutuals' | 'none'>;
+type AllowActivitySubscriptions = Extract<app.bsky.notification.declaration.Main['allowSubscriptions'], 'followers' | 'mutuals' | 'none'>;
 export type Actor = {
-    did: string;
-    handle?: string;
+    did: DidString;
+    handle?: HandleString;
     profile?: ProfileRecord;
     profileCid?: string;
     profileTakedownRef?: string;
@@ -34,47 +31,47 @@ export type Actor = {
         pagerank?: string;
         accountTags?: string[];
         profileTags?: string[];
-        [key: string]: unknown;
     };
 };
 export type VerificationHydrationState = {
-    issuer: string;
-    uri: string;
-    handle: string;
+    issuer: DidString;
+    uri: AtUriString;
+    handle: HandleString;
     displayName: string;
-    createdAt: string;
+    createdAt: DatetimeString;
 };
 export type VerificationMetaRequired = Required<VerificationMeta>;
-export type Actors = HydrationMap<Actor>;
+export type Actors = HydrationMap<DidString, Actor>;
 export type ChatDeclaration = RecordInfo<ChatDeclarationRecord>;
-export type ChatDeclarations = HydrationMap<ChatDeclaration>;
+export type ChatDeclarations = HydrationMap<AtUriString, ChatDeclaration>;
 export type GermDeclaration = RecordInfo<GermDeclarationRecord>;
-export type GermDeclarations = HydrationMap<GermDeclaration>;
+export type GermDeclarations = HydrationMap<AtUriString, GermDeclaration>;
 export type NotificationDeclaration = RecordInfo<NotificationDeclarationRecord>;
-export type NotificationDeclarations = HydrationMap<NotificationDeclaration>;
+export type NotificationDeclarations = HydrationMap<AtUriString, NotificationDeclaration>;
 export type Status = RecordInfo<StatusRecord>;
-export type Statuses = HydrationMap<Status>;
+export type Statuses = HydrationMap<AtUriString, Status>;
 export type ProfileViewerState = {
+    did: DidString;
     muted?: boolean;
-    mutedByList?: string;
-    blockedBy?: string;
-    blocking?: string;
-    blockedByList?: string;
-    blockingByList?: string;
-    following?: string;
-    followedBy?: string;
+    mutedByList?: AtUriString;
+    blockedBy?: AtUriString;
+    blocking?: AtUriString;
+    blockedByList?: AtUriString;
+    blockingByList?: AtUriString;
+    following?: AtUriString;
+    followedBy?: AtUriString;
 };
-export type ProfileViewerStates = HydrationMap<ProfileViewerState>;
+export type ProfileViewerStates = HydrationMap<AtIdentifierString, ProfileViewerState>;
 type ActivitySubscriptionState = {
     post: boolean;
     reply: boolean;
 };
-export type ActivitySubscriptionStates = HydrationMap<ActivitySubscriptionState | undefined>;
+export type ActivitySubscriptionStates = HydrationMap<DidString, ActivitySubscriptionState | undefined>;
 type KnownFollowersState = {
     count: number;
-    followers: string[];
+    followers: DidString[];
 };
-export type KnownFollowersStates = HydrationMap<KnownFollowersState | undefined>;
+export type KnownFollowersStates = HydrationMap<DidString, KnownFollowersState | undefined>;
 export type ProfileAgg = {
     followers: number;
     follows: number;
@@ -83,27 +80,30 @@ export type ProfileAgg = {
     feeds: number;
     starterPacks: number;
 };
-export type ProfileAggs = HydrationMap<ProfileAgg>;
+export type ProfileAggs = HydrationMap<DidString, ProfileAgg>;
 export declare class ActorHydrator {
     dataplane: DataPlaneClient;
     constructor(dataplane: DataPlaneClient);
     getRepoRevSafe(did: string | null): Promise<string | null>;
-    getDids(handleOrDids: string[], opts?: {
+    /**
+     * @note handles do not need to be normalized
+     */
+    getDids(handleOrDids: AtIdentifierString[], opts?: {
         lookupUnidirectional?: boolean;
-    }): Promise<(string | undefined)[]>;
-    getDidsDefined(handleOrDids: string[]): Promise<string[]>;
-    getActors(dids: string[], opts?: {
+    }): Promise<(DidString | undefined)[]>;
+    getDidsDefined(handleOrDids: AtIdentifierString[]): Promise<DidString[]>;
+    getActors(dids: DidString[], opts?: {
         includeTakedowns?: boolean;
-        skipCacheForDids?: string[];
+        skipCacheForDids?: DidString[];
     }): Promise<Actors>;
-    getChatDeclarations(uris: string[], includeTakedowns?: boolean): Promise<ChatDeclarations>;
-    getGermDeclarations(uris: string[], includeTakedowns?: boolean): Promise<GermDeclarations>;
-    getNotificationDeclarations(uris: string[], includeTakedowns?: boolean): Promise<NotificationDeclarations>;
-    getStatus(uris: string[], includeTakedowns?: boolean): Promise<Statuses>;
-    getProfileViewerStatesNaive(dids: string[], viewer: string): Promise<ProfileViewerStates>;
-    getKnownFollowers(dids: string[], viewer: string | null): Promise<KnownFollowersStates>;
-    getActivitySubscriptions(dids: string[], viewer: string | null): Promise<ActivitySubscriptionStates>;
-    getProfileAggregates(dids: string[]): Promise<ProfileAggs>;
+    getChatDeclarations(uris: AtUriString[], includeTakedowns?: boolean): Promise<ChatDeclarations>;
+    getGermDeclarations(uris: AtUriString[], includeTakedowns?: boolean): Promise<GermDeclarations>;
+    getNotificationDeclarations(uris: AtUriString[], includeTakedowns?: boolean): Promise<NotificationDeclarations>;
+    getStatus(uris: AtUriString[], includeTakedowns?: boolean): Promise<Statuses>;
+    getProfileViewerStatesNaive(actors: AtIdentifierString[], viewer: DidString): Promise<ProfileViewerStates>;
+    getKnownFollowers(dids: DidString[], viewer: DidString | null): Promise<KnownFollowersStates>;
+    getActivitySubscriptions(dids: DidString[], viewer: DidString | null): Promise<ActivitySubscriptionStates>;
+    getProfileAggregates(dids: DidString[]): Promise<ProfileAggs>;
 }
 export {};
 //# sourceMappingURL=actor.d.ts.map

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

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