featuredrop 1.2.0 → 1.3.0

package/dist/flags.cjs

@@ -0,0 +1,51 @@
+'use strict';
+
+// src/flags.ts
+function createFlagBridge(options) {
+  return {
+    isEnabled: (flagKey, userContext) => {
+      if (!flagKey) return false;
+      return options.isEnabled(flagKey, userContext);
+    }
+  };
+}
+var LaunchDarklyBridge = class {
+  client;
+  options;
+  constructor(client, options = {}) {
+    this.client = client;
+    this.options = options;
+  }
+  isEnabled(flagKey, userContext) {
+    const defaultUser = {
+      key: userContext?.traits?.id ?? userContext?.role ?? "anonymous",
+      custom: {
+        plan: userContext?.plan,
+        role: userContext?.role,
+        region: userContext?.region,
+        ...userContext?.traits ?? {}
+      }
+    };
+    const user = this.options.userResolver ? this.options.userResolver(userContext) : defaultUser;
+    return this.client.variation(flagKey, user, this.options.defaultValue ?? false);
+  }
+};
+var PostHogBridge = class {
+  client;
+  options;
+  constructor(client, options = {}) {
+    this.client = client;
+    this.options = options;
+  }
+  isEnabled(flagKey, userContext) {
+    const distinctId = this.options.distinctIdResolver ? this.options.distinctIdResolver(userContext) : typeof userContext?.traits?.id === "string" ? userContext.traits.id : void 0;
+    const groups = this.options.groupsResolver ? this.options.groupsResolver(userContext) : void 0;
+    return this.client.isFeatureEnabled(flagKey, distinctId, groups, userContext?.traits);
+  }
+};
+
+exports.LaunchDarklyBridge = LaunchDarklyBridge;
+exports.PostHogBridge = PostHogBridge;
+exports.createFlagBridge = createFlagBridge;
+//# sourceMappingURL=flags.cjs.map
+//# sourceMappingURL=flags.cjs.map

package/dist/flags.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/flags.ts"],"names":[],"mappings":";;;AAMO,SAAS,iBAAiB,OAAA,EAAqD;AACpF,EAAA,OAAO;AAAA,IACL,SAAA,EAAW,CAAC,OAAA,EAAiB,WAAA,KAA8B;AACzD,MAAA,IAAI,CAAC,SAAS,OAAO,KAAA;AACrB,MAAA,OAAO,OAAA,CAAQ,SAAA,CAAU,OAAA,EAAS,WAAW,CAAA;AAAA,IAC/C;AAAA,GACF;AACF;AAWO,IAAM,qBAAN,MAAsD;AAAA,EAC1C,MAAA;AAAA,EACA,OAAA;AAAA,EAEjB,WAAA,CAAY,MAAA,EAAgC,OAAA,GAAqC,EAAC,EAAG;AACnF,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AAAA,EACjB;AAAA,EAEA,SAAA,CAAU,SAAiB,WAAA,EAAoC;AAC7D,IAAA,MAAM,WAAA,GAAc;AAAA,MAClB,GAAA,EAAK,WAAA,EAAa,MAAA,EAAQ,EAAA,IAAM,aAAa,IAAA,IAAQ,WAAA;AAAA,MACrD,MAAA,EAAQ;AAAA,QACN,MAAM,WAAA,EAAa,IAAA;AAAA,QACnB,MAAM,WAAA,EAAa,IAAA;AAAA,QACnB,QAAQ,WAAA,EAAa,MAAA;AAAA,QACrB,GAAI,WAAA,EAAa,MAAA,IAAU;AAAC;AAC9B,KACF;AACA,IAAA,MAAM,IAAA,GAAO,KAAK,OAAA,CAAQ,YAAA,GAAe,KAAK,OAAA,CAAQ,YAAA,CAAa,WAAW,CAAA,GAAI,WAAA;AAClF,IAAA,OAAO,IAAA,CAAK,OAAO,SAAA,CAAU,OAAA,EAAS,MAAM,IAAA,CAAK,OAAA,CAAQ,gBAAgB,KAAK,CAAA;AAAA,EAChF;AACF;AAgBO,IAAM,gBAAN,MAAiD;AAAA,EACrC,MAAA;AAAA,EACA,OAAA;AAAA,EAEjB,WAAA,CAAY,MAAA,EAA2B,OAAA,GAAgC,EAAC,EAAG;AACzE,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AAAA,EACjB;AAAA,EAEA,SAAA,CAAU,SAAiB,WAAA,EAAoC;AAC7D,IAAA,MAAM,aAAa,IAAA,CAAK,OAAA,CAAQ,kBAAA,GAC5B,IAAA,CAAK,QAAQ,kBAAA,CAAmB,WAAW,CAAA,GAC1C,OAAO,aAAa,MAAA,EAAQ,EAAA,KAAO,QAAA,GAAW,WAAA,CAAY,OAAO,EAAA,GAAK,MAAA;AAC3E,IAAA,MAAM,MAAA,GAAS,KAAK,OAAA,CAAQ,cAAA,GACxB,KAAK,OAAA,CAAQ,cAAA,CAAe,WAAW,CAAA,GACvC,MAAA;AACJ,IAAA,OAAO,KAAK,MAAA,CAAO,gBAAA,CAAiB,SAAS,UAAA,EAAY,MAAA,EAAQ,aAAa,MAAM,CAAA;AAAA,EACtF;AACF","file":"flags.cjs","sourcesContent":["import type { FeatureFlagBridge, UserContext } from \"./types\";\n\nexport interface CreateFlagBridgeOptions {\n  isEnabled: (flagKey: string, userContext?: UserContext) => boolean;\n}\n\nexport function createFlagBridge(options: CreateFlagBridgeOptions): FeatureFlagBridge {\n  return {\n    isEnabled: (flagKey: string, userContext?: UserContext) => {\n      if (!flagKey) return false;\n      return options.isEnabled(flagKey, userContext);\n    },\n  };\n}\n\nexport interface LaunchDarklyClientLike {\n  variation: (flagKey: string, user: Record<string, unknown>, defaultValue: boolean) => boolean;\n}\n\nexport interface LaunchDarklyBridgeOptions {\n  userResolver?: (userContext?: UserContext) => Record<string, unknown>;\n  defaultValue?: boolean;\n}\n\nexport class LaunchDarklyBridge implements FeatureFlagBridge {\n  private readonly client: LaunchDarklyClientLike;\n  private readonly options: LaunchDarklyBridgeOptions;\n\n  constructor(client: LaunchDarklyClientLike, options: LaunchDarklyBridgeOptions = {}) {\n    this.client = client;\n    this.options = options;\n  }\n\n  isEnabled(flagKey: string, userContext?: UserContext): boolean {\n    const defaultUser = {\n      key: userContext?.traits?.id ?? userContext?.role ?? \"anonymous\",\n      custom: {\n        plan: userContext?.plan,\n        role: userContext?.role,\n        region: userContext?.region,\n        ...(userContext?.traits ?? {}),\n      },\n    };\n    const user = this.options.userResolver ? this.options.userResolver(userContext) : defaultUser;\n    return this.client.variation(flagKey, user, this.options.defaultValue ?? false);\n  }\n}\n\nexport interface PostHogClientLike {\n  isFeatureEnabled: (\n    flagKey: string,\n    distinctId?: string,\n    groups?: Record<string, string>,\n    personProperties?: Record<string, unknown>,\n  ) => boolean;\n}\n\nexport interface PostHogBridgeOptions {\n  distinctIdResolver?: (userContext?: UserContext) => string | undefined;\n  groupsResolver?: (userContext?: UserContext) => Record<string, string> | undefined;\n}\n\nexport class PostHogBridge implements FeatureFlagBridge {\n  private readonly client: PostHogClientLike;\n  private readonly options: PostHogBridgeOptions;\n\n  constructor(client: PostHogClientLike, options: PostHogBridgeOptions = {}) {\n    this.client = client;\n    this.options = options;\n  }\n\n  isEnabled(flagKey: string, userContext?: UserContext): boolean {\n    const distinctId = this.options.distinctIdResolver\n      ? this.options.distinctIdResolver(userContext)\n      : (typeof userContext?.traits?.id === \"string\" ? userContext.traits.id : undefined);\n    const groups = this.options.groupsResolver\n      ? this.options.groupsResolver(userContext)\n      : undefined;\n    return this.client.isFeatureEnabled(flagKey, distinctId, groups, userContext?.traits);\n  }\n}\n"]}

package/dist/flags.d.cts

@@ -0,0 +1,48 @@
+/** User context for audience targeting */
+interface UserContext {
+    /** Current user's plan (e.g. "pro", "free") */
+    plan?: string;
+    /** Current user's role (e.g. "admin", "viewer") */
+    role?: string;
+    /** Current user's region (e.g. "us", "eu") */
+    region?: string;
+    /** Arbitrary traits for custom matching logic */
+    traits?: Record<string, unknown>;
+}
+/** Feature flag resolver interface for gating announcement visibility */
+interface FeatureFlagBridge {
+    isEnabled: (flagKey: string, userContext?: UserContext) => boolean;
+}
+
+interface CreateFlagBridgeOptions {
+    isEnabled: (flagKey: string, userContext?: UserContext) => boolean;
+}
+declare function createFlagBridge(options: CreateFlagBridgeOptions): FeatureFlagBridge;
+interface LaunchDarklyClientLike {
+    variation: (flagKey: string, user: Record<string, unknown>, defaultValue: boolean) => boolean;
+}
+interface LaunchDarklyBridgeOptions {
+    userResolver?: (userContext?: UserContext) => Record<string, unknown>;
+    defaultValue?: boolean;
+}
+declare class LaunchDarklyBridge implements FeatureFlagBridge {
+    private readonly client;
+    private readonly options;
+    constructor(client: LaunchDarklyClientLike, options?: LaunchDarklyBridgeOptions);
+    isEnabled(flagKey: string, userContext?: UserContext): boolean;
+}
+interface PostHogClientLike {
+    isFeatureEnabled: (flagKey: string, distinctId?: string, groups?: Record<string, string>, personProperties?: Record<string, unknown>) => boolean;
+}
+interface PostHogBridgeOptions {
+    distinctIdResolver?: (userContext?: UserContext) => string | undefined;
+    groupsResolver?: (userContext?: UserContext) => Record<string, string> | undefined;
+}
+declare class PostHogBridge implements FeatureFlagBridge {
+    private readonly client;
+    private readonly options;
+    constructor(client: PostHogClientLike, options?: PostHogBridgeOptions);
+    isEnabled(flagKey: string, userContext?: UserContext): boolean;
+}
+
+export { type CreateFlagBridgeOptions, LaunchDarklyBridge, type LaunchDarklyBridgeOptions, type LaunchDarklyClientLike, PostHogBridge, type PostHogBridgeOptions, type PostHogClientLike, createFlagBridge };

package/dist/flags.d.ts

@@ -0,0 +1,48 @@
+/** User context for audience targeting */
+interface UserContext {
+    /** Current user's plan (e.g. "pro", "free") */
+    plan?: string;
+    /** Current user's role (e.g. "admin", "viewer") */
+    role?: string;
+    /** Current user's region (e.g. "us", "eu") */
+    region?: string;
+    /** Arbitrary traits for custom matching logic */
+    traits?: Record<string, unknown>;
+}
+/** Feature flag resolver interface for gating announcement visibility */
+interface FeatureFlagBridge {
+    isEnabled: (flagKey: string, userContext?: UserContext) => boolean;
+}
+
+interface CreateFlagBridgeOptions {
+    isEnabled: (flagKey: string, userContext?: UserContext) => boolean;
+}
+declare function createFlagBridge(options: CreateFlagBridgeOptions): FeatureFlagBridge;
+interface LaunchDarklyClientLike {
+    variation: (flagKey: string, user: Record<string, unknown>, defaultValue: boolean) => boolean;
+}
+interface LaunchDarklyBridgeOptions {
+    userResolver?: (userContext?: UserContext) => Record<string, unknown>;
+    defaultValue?: boolean;
+}
+declare class LaunchDarklyBridge implements FeatureFlagBridge {
+    private readonly client;
+    private readonly options;
+    constructor(client: LaunchDarklyClientLike, options?: LaunchDarklyBridgeOptions);
+    isEnabled(flagKey: string, userContext?: UserContext): boolean;
+}
+interface PostHogClientLike {
+    isFeatureEnabled: (flagKey: string, distinctId?: string, groups?: Record<string, string>, personProperties?: Record<string, unknown>) => boolean;
+}
+interface PostHogBridgeOptions {
+    distinctIdResolver?: (userContext?: UserContext) => string | undefined;
+    groupsResolver?: (userContext?: UserContext) => Record<string, string> | undefined;
+}
+declare class PostHogBridge implements FeatureFlagBridge {
+    private readonly client;
+    private readonly options;
+    constructor(client: PostHogClientLike, options?: PostHogBridgeOptions);
+    isEnabled(flagKey: string, userContext?: UserContext): boolean;
+}
+
+export { type CreateFlagBridgeOptions, LaunchDarklyBridge, type LaunchDarklyBridgeOptions, type LaunchDarklyClientLike, PostHogBridge, type PostHogBridgeOptions, type PostHogClientLike, createFlagBridge };

package/dist/flags.js

@@ -0,0 +1,47 @@
+// src/flags.ts
+function createFlagBridge(options) {
+  return {
+    isEnabled: (flagKey, userContext) => {
+      if (!flagKey) return false;
+      return options.isEnabled(flagKey, userContext);
+    }
+  };
+}
+var LaunchDarklyBridge = class {
+  client;
+  options;
+  constructor(client, options = {}) {
+    this.client = client;
+    this.options = options;
+  }
+  isEnabled(flagKey, userContext) {
+    const defaultUser = {
+      key: userContext?.traits?.id ?? userContext?.role ?? "anonymous",
+      custom: {
+        plan: userContext?.plan,
+        role: userContext?.role,
+        region: userContext?.region,
+        ...userContext?.traits ?? {}
+      }
+    };
+    const user = this.options.userResolver ? this.options.userResolver(userContext) : defaultUser;
+    return this.client.variation(flagKey, user, this.options.defaultValue ?? false);
+  }
+};
+var PostHogBridge = class {
+  client;
+  options;
+  constructor(client, options = {}) {
+    this.client = client;
+    this.options = options;
+  }
+  isEnabled(flagKey, userContext) {
+    const distinctId = this.options.distinctIdResolver ? this.options.distinctIdResolver(userContext) : typeof userContext?.traits?.id === "string" ? userContext.traits.id : void 0;
+    const groups = this.options.groupsResolver ? this.options.groupsResolver(userContext) : void 0;
+    return this.client.isFeatureEnabled(flagKey, distinctId, groups, userContext?.traits);
+  }
+};
+
+export { LaunchDarklyBridge, PostHogBridge, createFlagBridge };
+//# sourceMappingURL=flags.js.map
+//# sourceMappingURL=flags.js.map

package/dist/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/flags.ts"],"names":[],"mappings":";AAMO,SAAS,iBAAiB,OAAA,EAAqD;AACpF,EAAA,OAAO;AAAA,IACL,SAAA,EAAW,CAAC,OAAA,EAAiB,WAAA,KAA8B;AACzD,MAAA,IAAI,CAAC,SAAS,OAAO,KAAA;AACrB,MAAA,OAAO,OAAA,CAAQ,SAAA,CAAU,OAAA,EAAS,WAAW,CAAA;AAAA,IAC/C;AAAA,GACF;AACF;AAWO,IAAM,qBAAN,MAAsD;AAAA,EAC1C,MAAA;AAAA,EACA,OAAA;AAAA,EAEjB,WAAA,CAAY,MAAA,EAAgC,OAAA,GAAqC,EAAC,EAAG;AACnF,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AAAA,EACjB;AAAA,EAEA,SAAA,CAAU,SAAiB,WAAA,EAAoC;AAC7D,IAAA,MAAM,WAAA,GAAc;AAAA,MAClB,GAAA,EAAK,WAAA,EAAa,MAAA,EAAQ,EAAA,IAAM,aAAa,IAAA,IAAQ,WAAA;AAAA,MACrD,MAAA,EAAQ;AAAA,QACN,MAAM,WAAA,EAAa,IAAA;AAAA,QACnB,MAAM,WAAA,EAAa,IAAA;AAAA,QACnB,QAAQ,WAAA,EAAa,MAAA;AAAA,QACrB,GAAI,WAAA,EAAa,MAAA,IAAU;AAAC;AAC9B,KACF;AACA,IAAA,MAAM,IAAA,GAAO,KAAK,OAAA,CAAQ,YAAA,GAAe,KAAK,OAAA,CAAQ,YAAA,CAAa,WAAW,CAAA,GAAI,WAAA;AAClF,IAAA,OAAO,IAAA,CAAK,OAAO,SAAA,CAAU,OAAA,EAAS,MAAM,IAAA,CAAK,OAAA,CAAQ,gBAAgB,KAAK,CAAA;AAAA,EAChF;AACF;AAgBO,IAAM,gBAAN,MAAiD;AAAA,EACrC,MAAA;AAAA,EACA,OAAA;AAAA,EAEjB,WAAA,CAAY,MAAA,EAA2B,OAAA,GAAgC,EAAC,EAAG;AACzE,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AAAA,EACjB;AAAA,EAEA,SAAA,CAAU,SAAiB,WAAA,EAAoC;AAC7D,IAAA,MAAM,aAAa,IAAA,CAAK,OAAA,CAAQ,kBAAA,GAC5B,IAAA,CAAK,QAAQ,kBAAA,CAAmB,WAAW,CAAA,GAC1C,OAAO,aAAa,MAAA,EAAQ,EAAA,KAAO,QAAA,GAAW,WAAA,CAAY,OAAO,EAAA,GAAK,MAAA;AAC3E,IAAA,MAAM,MAAA,GAAS,KAAK,OAAA,CAAQ,cAAA,GACxB,KAAK,OAAA,CAAQ,cAAA,CAAe,WAAW,CAAA,GACvC,MAAA;AACJ,IAAA,OAAO,KAAK,MAAA,CAAO,gBAAA,CAAiB,SAAS,UAAA,EAAY,MAAA,EAAQ,aAAa,MAAM,CAAA;AAAA,EACtF;AACF","file":"flags.js","sourcesContent":["import type { FeatureFlagBridge, UserContext } from \"./types\";\n\nexport interface CreateFlagBridgeOptions {\n  isEnabled: (flagKey: string, userContext?: UserContext) => boolean;\n}\n\nexport function createFlagBridge(options: CreateFlagBridgeOptions): FeatureFlagBridge {\n  return {\n    isEnabled: (flagKey: string, userContext?: UserContext) => {\n      if (!flagKey) return false;\n      return options.isEnabled(flagKey, userContext);\n    },\n  };\n}\n\nexport interface LaunchDarklyClientLike {\n  variation: (flagKey: string, user: Record<string, unknown>, defaultValue: boolean) => boolean;\n}\n\nexport interface LaunchDarklyBridgeOptions {\n  userResolver?: (userContext?: UserContext) => Record<string, unknown>;\n  defaultValue?: boolean;\n}\n\nexport class LaunchDarklyBridge implements FeatureFlagBridge {\n  private readonly client: LaunchDarklyClientLike;\n  private readonly options: LaunchDarklyBridgeOptions;\n\n  constructor(client: LaunchDarklyClientLike, options: LaunchDarklyBridgeOptions = {}) {\n    this.client = client;\n    this.options = options;\n  }\n\n  isEnabled(flagKey: string, userContext?: UserContext): boolean {\n    const defaultUser = {\n      key: userContext?.traits?.id ?? userContext?.role ?? \"anonymous\",\n      custom: {\n        plan: userContext?.plan,\n        role: userContext?.role,\n        region: userContext?.region,\n        ...(userContext?.traits ?? {}),\n      },\n    };\n    const user = this.options.userResolver ? this.options.userResolver(userContext) : defaultUser;\n    return this.client.variation(flagKey, user, this.options.defaultValue ?? false);\n  }\n}\n\nexport interface PostHogClientLike {\n  isFeatureEnabled: (\n    flagKey: string,\n    distinctId?: string,\n    groups?: Record<string, string>,\n    personProperties?: Record<string, unknown>,\n  ) => boolean;\n}\n\nexport interface PostHogBridgeOptions {\n  distinctIdResolver?: (userContext?: UserContext) => string | undefined;\n  groupsResolver?: (userContext?: UserContext) => Record<string, string> | undefined;\n}\n\nexport class PostHogBridge implements FeatureFlagBridge {\n  private readonly client: PostHogClientLike;\n  private readonly options: PostHogBridgeOptions;\n\n  constructor(client: PostHogClientLike, options: PostHogBridgeOptions = {}) {\n    this.client = client;\n    this.options = options;\n  }\n\n  isEnabled(flagKey: string, userContext?: UserContext): boolean {\n    const distinctId = this.options.distinctIdResolver\n      ? this.options.distinctIdResolver(userContext)\n      : (typeof userContext?.traits?.id === \"string\" ? userContext.traits.id : undefined);\n    const groups = this.options.groupsResolver\n      ? this.options.groupsResolver(userContext)\n      : undefined;\n    return this.client.isFeatureEnabled(flagKey, distinctId, groups, userContext?.traits);\n  }\n}\n"]}