@flagshark/core 2.0.0 → 2.1.1

package/README.md

@@ -4,6 +4,8 @@ The detection engine behind [FlagShark](https://github.com/FlagShark/flagshark)
 
 This is the **library**. For a CLI or GitHub Action, install [`flagshark`](https://www.npmjs.com/package/flagshark) instead.
 
+📚 **Library documentation: [flagshark.com/docs/getting-started/library](https://flagshark.com/docs/getting-started/library/)**
+
 ## Install
 
 ```bash

package/dist/config/schema.d.ts

@@ -75,6 +75,70 @@ export declare const CustomProviderSchema: z.ZodObject<{
     importPattern?: string | undefined;
     enabled?: boolean | undefined;
 }>;
+/**
+ * Escape hatch for typed config-struct flag systems (B3).
+ *
+ * Codebases like Mattermost don't use an SDK — flags are typed fields on a
+ * configuration struct:
+ *
+ *   if (server.Config().FeatureFlags.EnableSharedChannelsMemberSync) { ... }
+ *
+ * There's no `import 'unleash-client'`, no `client.variation(...)`, no string
+ * literal flag key. The standard import-gated detection model returns 0 on
+ * these codebases because none of its preconditions hold (see the
+ * design spec at docs/superpowers/specs/2026-05-24-static-config-flag-detection.md).
+ *
+ * Users opt in by declaring the access pattern in `.flagshark.yml`:
+ *
+ *   custom_detectors:
+ *     - type: struct-field-access
+ *       language: go
+ *       access_pattern: '\.FeatureFlags\.([A-Z]\w+)'
+ *
+ * The capture group is the flag name. Files matching this regex are added
+ * to detection results with `confidence: 'low'` so downstream tooling
+ * surfaces them for manual review — false-positive risk on heuristic
+ * matches is real and the user is the one who said "trust this pattern".
+ *
+ * We deliberately do NOT auto-discover the struct definition + enumerate
+ * its fields (the more aggressive design path from the spec). Reasons:
+ * each codebase invents its own pattern (Mattermost, Kubernetes, Grafana
+ * each have different shapes) and chasing them is N customer-engagements
+ * of work. The config-driven approach scales — users with bespoke
+ * patterns can express them; we don't have to encode every variant.
+ */
+export declare const CustomDetectorSchema: z.ZodObject<{
+    /**
+     * Detector kind. Today only `struct-field-access` is supported; future
+     * kinds (e.g. `runtime-symbol`, `type-assertion`) would slot in here
+     * without breaking the schema.
+     */
+    type: z.ZodLiteral<"struct-field-access">;
+    /** Language whose file extensions this detector applies to. */
+    language: z.ZodEnum<["typescript", "javascript", "go", "python", "java", "kotlin", "swift", "ruby", "csharp", "php", "rust", "cpp", "objc"]>;
+    /**
+     * Regex with exactly one capture group — the captured text becomes the
+     * detected flag name. Run as a global regex over file content. Must be
+     * a string (parsed at load time) so the YAML stays plain-data.
+     */
+    access_pattern: z.ZodString;
+    /**
+     * Optional display name surfaced as the `provider` for matched flags.
+     * Defaults to "Custom struct-field detector" so JSON consumers can
+     * filter on a stable string.
+     */
+    name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "struct-field-access";
+    language: "go" | "typescript" | "javascript" | "python" | "java" | "kotlin" | "swift" | "ruby" | "csharp" | "php" | "rust" | "cpp" | "objc";
+    access_pattern: string;
+    name?: string | undefined;
+}, {
+    type: "struct-field-access";
+    language: "go" | "typescript" | "javascript" | "python" | "java" | "kotlin" | "swift" | "ruby" | "csharp" | "php" | "rust" | "cpp" | "objc";
+    access_pattern: string;
+    name?: string | undefined;
+}>;
 export declare const OutputConfigSchema: z.ZodDefault<z.ZodObject<{
     format: z.ZodDefault<z.ZodEnum<["text", "json", "sarif", "markdown", "csv"]>>;
     groupBy: z.ZodDefault<z.ZodEnum<["file", "provider", "signal", "none"]>>;
@@ -188,6 +252,42 @@ export declare const FlagsharkConfigSchema: z.ZodObject<{
         importPattern?: string | undefined;
         enabled?: boolean | undefined;
     }>, "many">>;
+    /**
+     * User-defined non-SDK detectors (B3). Today only `struct-field-access`.
+     * See `CustomDetectorSchema` for the rationale + per-codebase examples.
+     */
+    custom_detectors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        /**
+         * Detector kind. Today only `struct-field-access` is supported; future
+         * kinds (e.g. `runtime-symbol`, `type-assertion`) would slot in here
+         * without breaking the schema.
+         */
+        type: z.ZodLiteral<"struct-field-access">;
+        /** Language whose file extensions this detector applies to. */
+        language: z.ZodEnum<["typescript", "javascript", "go", "python", "java", "kotlin", "swift", "ruby", "csharp", "php", "rust", "cpp", "objc"]>;
+        /**
+         * Regex with exactly one capture group — the captured text becomes the
+         * detected flag name. Run as a global regex over file content. Must be
+         * a string (parsed at load time) so the YAML stays plain-data.
+         */
+        access_pattern: z.ZodString;
+        /**
+         * Optional display name surfaced as the `provider` for matched flags.
+         * Defaults to "Custom struct-field detector" so JSON consumers can
+         * filter on a stable string.
+         */
+        name: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "struct-field-access";
+        language: "go" | "typescript" | "javascript" | "python" | "java" | "kotlin" | "swift" | "ruby" | "csharp" | "php" | "rust" | "cpp" | "objc";
+        access_pattern: string;
+        name?: string | undefined;
+    }, {
+        type: "struct-field-access";
+        language: "go" | "typescript" | "javascript" | "python" | "java" | "kotlin" | "swift" | "ruby" | "csharp" | "php" | "rust" | "cpp" | "objc";
+        access_pattern: string;
+        name?: string | undefined;
+    }>, "many">>;
     output: z.ZodDefault<z.ZodObject<{
         format: z.ZodDefault<z.ZodEnum<["text", "json", "sarif", "markdown", "csv"]>>;
         groupBy: z.ZodDefault<z.ZodEnum<["file", "provider", "signal", "none"]>>;
@@ -267,6 +367,12 @@ export declare const FlagsharkConfigSchema: z.ZodObject<{
     suppress: {
         flags: string[];
     };
+    custom_detectors: {
+        type: "struct-field-access";
+        language: "go" | "typescript" | "javascript" | "python" | "java" | "kotlin" | "swift" | "ruby" | "csharp" | "php" | "rust" | "cpp" | "objc";
+        access_pattern: string;
+        name?: string | undefined;
+    }[];
     output: {
         format: "json" | "text" | "sarif" | "markdown" | "csv";
         groupBy: "provider" | "file" | "signal" | "none";
@@ -309,6 +415,12 @@ export declare const FlagsharkConfigSchema: z.ZodObject<{
     suppress?: {
         flags?: string[] | undefined;
     } | undefined;
+    custom_detectors?: {
+        type: "struct-field-access";
+        language: "go" | "typescript" | "javascript" | "python" | "java" | "kotlin" | "swift" | "ruby" | "csharp" | "php" | "rust" | "cpp" | "objc";
+        access_pattern: string;
+        name?: string | undefined;
+    }[] | undefined;
     output?: {
         format?: "json" | "text" | "sarif" | "markdown" | "csv" | undefined;
         groupBy?: "provider" | "file" | "signal" | "none" | undefined;

package/dist/config/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAWvB,eAAO,MAAM,gBAAgB,wFAAuB,CAAA;AACpD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEzD,eAAO,MAAM,cAAc;;;;;;;;;;;;GAIb,CAAA;AAEd,eAAO,MAAM,cAAc;;;;;;GAEb,CAAA;AAEd,eAAO,MAAM,cAAc;;;;;;;;;EAGzB,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAA;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU/B,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;GAMjB,CAAA;AAEd,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;GAMhB,CAAA;AAEd,eAAO,MAAM,YAAY,6EAGZ,CAAA;AAEb,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAavB,CAAA;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AACnE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAC3D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAC3D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAC3D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAWvB,eAAO,MAAM,gBAAgB,wFAAuB,CAAA;AACpD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEzD,eAAO,MAAM,cAAc;;;;;;;;;;;;GAIb,CAAA;AAEd,eAAO,MAAM,cAAc;;;;;;GAEb,CAAA;AAEd,eAAO,MAAM,cAAc;;;;;;;;;EAGzB,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAA;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU/B,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;;;OAIG;;IAEH,+DAA+D;;IAM/D;;;;OAIG;;IAEH;;;;OAIG;;;;;;;;;;;;EAEH,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;GAMjB,CAAA;AAEd,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;GAMhB,CAAA;AAEd,eAAO,MAAM,YAAY,6EAGZ,CAAA;AAEb,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMhC;;;OAGG;;QAxDH;;;;WAIG;;QAEH,+DAA+D;;QAM/D;;;;WAIG;;QAEH;;;;WAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2CM,CAAA;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AACnE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAC3D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAC3D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAC3D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA"}

package/dist/config/schema.js

@@ -35,6 +35,64 @@ export const CustomProviderSchema = z.object({
     enabled: z.boolean().default(true),
     methods: z.array(MethodConfigSchema),
 });
+/**
+ * Escape hatch for typed config-struct flag systems (B3).
+ *
+ * Codebases like Mattermost don't use an SDK — flags are typed fields on a
+ * configuration struct:
+ *
+ *   if (server.Config().FeatureFlags.EnableSharedChannelsMemberSync) { ... }
+ *
+ * There's no `import 'unleash-client'`, no `client.variation(...)`, no string
+ * literal flag key. The standard import-gated detection model returns 0 on
+ * these codebases because none of its preconditions hold (see the
+ * design spec at docs/superpowers/specs/2026-05-24-static-config-flag-detection.md).
+ *
+ * Users opt in by declaring the access pattern in `.flagshark.yml`:
+ *
+ *   custom_detectors:
+ *     - type: struct-field-access
+ *       language: go
+ *       access_pattern: '\.FeatureFlags\.([A-Z]\w+)'
+ *
+ * The capture group is the flag name. Files matching this regex are added
+ * to detection results with `confidence: 'low'` so downstream tooling
+ * surfaces them for manual review — false-positive risk on heuristic
+ * matches is real and the user is the one who said "trust this pattern".
+ *
+ * We deliberately do NOT auto-discover the struct definition + enumerate
+ * its fields (the more aggressive design path from the spec). Reasons:
+ * each codebase invents its own pattern (Mattermost, Kubernetes, Grafana
+ * each have different shapes) and chasing them is N customer-engagements
+ * of work. The config-driven approach scales — users with bespoke
+ * patterns can express them; we don't have to encode every variant.
+ */
+export const CustomDetectorSchema = z.object({
+    /**
+     * Detector kind. Today only `struct-field-access` is supported; future
+     * kinds (e.g. `runtime-symbol`, `type-assertion`) would slot in here
+     * without breaking the schema.
+     */
+    type: z.literal('struct-field-access'),
+    /** Language whose file extensions this detector applies to. */
+    language: z.enum([
+        'typescript', 'javascript', 'go', 'python', 'java',
+        'kotlin', 'swift', 'ruby', 'csharp', 'php', 'rust',
+        'cpp', 'objc',
+    ]),
+    /**
+     * Regex with exactly one capture group — the captured text becomes the
+     * detected flag name. Run as a global regex over file content. Must be
+     * a string (parsed at load time) so the YAML stays plain-data.
+     */
+    access_pattern: z.string().min(1),
+    /**
+     * Optional display name surfaced as the `provider` for matched flags.
+     * Defaults to "Custom struct-field detector" so JSON consumers can
+     * filter on a stable string.
+     */
+    name: z.string().optional(),
+});
 export const OutputConfigSchema = z.object({
     format: z.enum(['text', 'json', 'sarif', 'markdown', 'csv']).default('text'),
     groupBy: z.enum(['file', 'provider', 'signal', 'none']).default('file'),
@@ -56,6 +114,11 @@ export const FlagsharkConfigSchema = z.object({
     suppress: SuppressSchema,
     paths: z.array(PathRuleSchema).default([]),
     providers: z.array(CustomProviderSchema).default([]),
+    /**
+     * User-defined non-SDK detectors (B3). Today only `struct-field-access`.
+     * See `CustomDetectorSchema` for the rationale + per-codebase examples.
+     */
+    custom_detectors: z.array(CustomDetectorSchema).default([]),
     output: OutputConfigSchema,
     healthScore: HealthScoreSchema,
     engine: EngineSchema,

package/dist/config/schema.js.map

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

package/dist/detection/detectors/typescript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../../src/detection/detectors/typescript.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEtG,YAAY,EAAE,cAAc,EAAE,CAAA;AAE9B,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAA;IACjC,MAAM,CAAC,EAAE,cAAc,CAAA;CACxB;AAED,qBAAa,kBAAmB,YAAW,gBAAgB;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,IAAI,GAAE,yBAA8B;IAKhD,QAAQ,IAAI,QAAQ;IAIpB,cAAc,IAAI,MAAM,EAAE;IAI1B,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAQvC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAOtF,YAAY,IAAI,mBAAmB,EAAE;CAGtC;AAED,wBAAgB,0BAA0B,IAAI,mBAAmB,EAAE,CAgUlE"}
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../../src/detection/detectors/typescript.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEtG,YAAY,EAAE,cAAc,EAAE,CAAA;AAE9B,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAA;IACjC,MAAM,CAAC,EAAE,cAAc,CAAA;CACxB;AAED,qBAAa,kBAAmB,YAAW,gBAAgB;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,IAAI,GAAE,yBAA8B;IAKhD,QAAQ,IAAI,QAAQ;IAIpB,cAAc,IAAI,MAAM,EAAE;IAI1B,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAQvC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAOtF,YAAY,IAAI,mBAAmB,EAAE;CAGtC;AAED,wBAAgB,0BAA0B,IAAI,mBAAmB,EAAE,CAyWlE"}

package/dist/detection/detectors/typescript.js

@@ -102,9 +102,36 @@ export function defaultTypeScriptProviders() {
         {
             name: 'LaunchDarkly React SDK',
             importPattern: '@launchdarkly/react-client-sdk',
+            // launchdarkly-react-client-sdk is the legacy unscoped package name
+            // still widely used; @launchdarkly/react-client-sdk is the current
+            // scoped name. Both ship the same hooks (useFlag, useFlags,
+            // useLDClient) so they share one provider config.
+            importAliases: ['launchdarkly-react-client-sdk'],
             description: 'LaunchDarkly React SDK',
             enabled: true,
+            // The React SDK has two flag-shaped surfaces:
+            //   1. `useFlag('flag-key', defaultValue)` — positional flag key,
+            //      handled by the standard pipeline (flagKeyIndex: 0).
+            //   2. `useFlags()` returns an object keyed by every flag; consumers
+            //      destructure or index into it. That second shape can't be
+            //      expressed as a positional arg, so the provider declares
+            //      `useFlagsHook` and the helpers run a second pass that
+            //      extracts flag keys from `const { flagX, flagY } = useFlags()`
+            //      destructures. See detectDestructuredHookFlags in helpers.ts.
+            // useLDClient is documented for completeness (it returns the SDK
+            // client and is used to call `.variation()` on it manually); when
+            // present, the `.variation()` site is detected by the JS SDK
+            // provider above. No standalone extraction is needed here.
+            useFlagsHook: 'useFlags',
             methods: [
+                {
+                    name: 'useFlag',
+                    flagKeyIndex: 0,
+                    examples: ["const enabled = useFlag('show-new-checkout', false)"],
+                },
+                // useFlags + useLDClient are documented here but produce no
+                // positional-arg matches (flagKeyIndex: -1 → skipped by the main
+                // loop). The useFlags extraction runs via useFlagsHook above.
                 { name: 'useFlags', flagKeyIndex: -1, examples: ['const { flagKey } = useFlags()'] },
                 { name: 'useLDClient', flagKeyIndex: -1, examples: ['const ldClient = useLDClient()'] },
             ],
@@ -299,6 +326,20 @@ export function defaultTypeScriptProviders() {
             importPattern: 'posthog-js',
             description: 'PostHog JavaScript/TypeScript SDK',
             enabled: true,
+            // Runtime-load symbols (B2). PostHog's canonical snippet attaches
+            // the SDK to `window.posthog` from a <script src=".../array.js">,
+            // so React/Vue/etc. consumer files never `import 'posthog-js'`
+            // directly. Without these symbols flagshark returns 0 on every
+            // PostHog frontend (n8n, PostHog's own dashboard, ...). The
+            // patterns are property-access shapes (with `.` separators) or
+            // call-shaped (with trailing `(`) so they don't match the bare
+            // string "posthog" in unrelated comments / docs.
+            runtimeSymbols: [
+                'window.posthog.',
+                'posthog.isFeatureEnabled(',
+                'posthog.getFeatureFlag(',
+                'posthog.getFeatureFlagPayload(',
+            ],
             methods: [
                 {
                     name: 'isFeatureEnabled',

package/dist/detection/detectors/typescript.js.map

@@ -1 +1 @@
-{"version":3,"file":"typescript.js","sourceRoot":"","sources":["../../../src/detection/detectors/typescript.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"typescript.js","sourceRoot":"","sources":["../../../src/detection/detectors/typescript.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AAYpE,MAAM,OAAO,kBAAkB;IACZ,SAAS,CAAuB;IAChC,MAAM,CAAgB;IAEvC,YAAY,OAAkC,EAAE;QAC9C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,0BAA0B,EAAE,CAAA;QAC/D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAA;IACtC,CAAC;IAED,QAAQ;QACN,OAAO,SAAS,CAAC,UAAU,CAAA;IAC7B,CAAC;IAED,cAAc;QACZ,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACvD,CAAC;IAED,YAAY,CAAC,QAAgB;QAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAA;QACpC,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;QACrC,IAAI,MAAM,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAA;QAC/B,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QACnC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;IAC/D,CAAC;IAED,WAAW,CAAC,QAAgB,EAAE,OAAe;QAC3C,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;YAClC,OAAO,yBAAyB,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;QACtF,CAAC;QACD,OAAO,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;IACjF,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAA;IACvB,CAAC;CACF;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL;YACE,IAAI,EAAE,6BAA6B;YACnC,aAAa,EAAE,6BAA6B;YAC5C,WAAW,EAAE,wCAAwC;YACrD,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,WAAW;oBACjB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,4CAA4C,CAAC;iBACzD;gBACD;oBACE,IAAI,EAAE,eAAe;oBACrB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,yCAAyC,CAAC;iBACtD;aACF;SACF;QACD;YACE,IAAI,EAAE,8BAA8B;YACpC,aAAa,EAAE,+BAA+B;YAC9C,WAAW,EAAE,iCAAiC;YAC9C,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,WAAW;oBACjB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,qDAAqD,CAAC;iBAClE;gBACD;oBACE,IAAI,EAAE,eAAe;oBACrB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,kDAAkD,CAAC;iBAC/D;gBACD;oBACE,IAAI,EAAE,iBAAiB;oBACvB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,wDAAwD,CAAC;iBACrE;gBACD;oBACE,IAAI,EAAE,cAAc;oBACpB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,6CAA6C,CAAC;iBAC1D;gBACD;oBACE,IAAI,EAAE,iBAAiB;oBACvB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,kDAAkD,CAAC;iBAC/D;gBACD;oBACE,IAAI,EAAE,eAAe;oBACrB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,+CAA+C,CAAC;iBAC5D;gBACD;oBACE,IAAI,EAAE,iBAAiB;oBACvB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,2DAA2D,CAAC;iBACxE;aACF;SACF;QACD;YACE,IAAI,EAAE,wBAAwB;YAC9B,aAAa,EAAE,gCAAgC;YAC/C,oEAAoE;YACpE,mEAAmE;YACnE,4DAA4D;YAC5D,kDAAkD;YAClD,aAAa,EAAE,CAAC,+BAA+B,CAAC;YAChD,WAAW,EAAE,wBAAwB;YACrC,OAAO,EAAE,IAAI;YACb,8CAA8C;YAC9C,kEAAkE;YAClE,2DAA2D;YAC3D,qEAAqE;YACrE,gEAAgE;YAChE,+DAA+D;YAC/D,6DAA6D;YAC7D,qEAAqE;YACrE,oEAAoE;YACpE,iEAAiE;YACjE,kEAAkE;YAClE,6DAA6D;YAC7D,2DAA2D;YAC3D,YAAY,EAAE,UAAU;YACxB,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,SAAS;oBACf,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,qDAAqD,CAAC;iBAClE;gBACD,4DAA4D;gBAC5D,iEAAiE;gBACjE,8DAA8D;gBAC9D,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,gCAAgC,CAAC,EAAE;gBACpF,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,gCAAgC,CAAC,EAAE;aACxF;SACF;QACD;YACE,IAAI,EAAE,8BAA8B;YACpC,aAAa,EAAE,8BAA8B;YAC7C,WAAW,EAAE,wCAAwC;YACrD,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,WAAW;oBACjB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,qDAAqD,CAAC;iBAClE;gBACD;oBACE,IAAI,EAAE,eAAe;oBACrB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,kDAAkD,CAAC;iBAC/D;aACF;SACF;QACD;YACE,IAAI,EAAE,wBAAwB;YAC9B,aAAa,EAAE,gBAAgB;YAC/B,WAAW,EAAE,mCAAmC;YAChD,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,qCAAqC,CAAC,EAAE;gBACzF,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,sCAAsC,CAAC,EAAE;aAC5F;SACF;QACD;YACE,IAAI,EAAE,yBAAyB;YAC/B,aAAa,EAAE,wBAAwB;YACvC,WAAW,EAAE,oCAAoC;YACjD,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,cAAc;oBACpB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,wCAAwC,CAAC;iBACrD;aACF;SACF;QACD;YACE,IAAI,EAAE,qBAAqB;YAC3B,aAAa,EAAE,qBAAqB;YACpC,WAAW,EAAE,6BAA6B;YAC1C,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,2BAA2B,CAAC,EAAE,CAAC;SACtF;QACD;YACE,IAAI,EAAE,2BAA2B;YACjC,aAAa,EAAE,4BAA4B;YAC3C,WAAW,EAAE,8DAA8D;YAC3E,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,kCAAkC,CAAC,EAAE;gBACnF;oBACE,IAAI,EAAE,eAAe;oBACrB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,2DAA2D,CAAC;iBACxE;gBACD,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,yBAAyB,CAAC,EAAE;aAC9E;SACF;QACD;YACE,IAAI,EAAE,0BAA0B;YAChC,aAAa,EAAE,WAAW;YAC1B,WAAW,EAAE,qCAAqC;YAClD,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,sCAAsC,CAAC,EAAE;gBAC3F,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,oCAAoC,CAAC,EAAE;aACxF;SACF;QACD;YACE,IAAI,EAAE,0BAA0B;YAChC,aAAa,EAAE,cAAc;YAC7B,WAAW,EAAE,qCAAqC;YAClD,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,UAAU;oBAChB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,2CAA2C,CAAC;iBACxD;gBACD;oBACE,IAAI,EAAE,eAAe;oBACrB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,sDAAsD,CAAC;iBACnE;aACF;SACF;QACD;YACE,IAAI,EAAE,sBAAsB;YAC5B,aAAa,EAAE,2BAA2B;YAC1C,WAAW,EAAE,iCAAiC;YAC9C,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,iBAAiB;oBACvB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,uDAAuD,CAAC;iBACpE;gBACD;oBACE,IAAI,EAAE,iBAAiB;oBACvB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,uDAAuD,CAAC;iBACpE;aACF;SACF;QACD;YACE,IAAI,EAAE,wBAAwB;YAC9B,aAAa,EAAE,YAAY;YAC3B,WAAW,EAAE,mCAAmC;YAChD,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,gCAAgC,CAAC,EAAE;gBACpF;oBACE,IAAI,EAAE,eAAe;oBACrB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,0CAA0C,CAAC;iBACvD;gBACD,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,kCAAkC,CAAC,EAAE;aACvF;SACF;QACD;YACE,IAAI,EAAE,2BAA2B;YACjC,aAAa,EAAE,wBAAwB;YACvC,WAAW,EAAE,sCAAsC;YACnD,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,wBAAwB,CAAC,EAAE;gBACvE;oBACE,IAAI,EAAE,iBAAiB;oBACvB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,kDAAkD,CAAC;iBAC/D;gBACD,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,+BAA+B,CAAC,EAAE;aACtF;SACF;QACD;YACE,IAAI,EAAE,yBAAyB;YAC/B,aAAa,EAAE,yBAAyB;YACxC,WAAW,EAAE,oCAAoC;YACjD,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,eAAe;oBACrB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,oDAAoD,CAAC;iBACjE;gBACD;oBACE,IAAI,EAAE,UAAU;oBAChB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,+CAA+C,CAAC;iBAC5D;aACF;SACF;QACD;YACE,IAAI,EAAE,qBAAqB;YAC3B,aAAa,EAAE,qBAAqB;YACpC,WAAW,EAAE,gCAAgC;YAC7C,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,sBAAsB;oBAC5B,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,uEAAuE,CAAC;iBACpF;gBACD;oBACE,IAAI,EAAE,qBAAqB;oBAC3B,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,sEAAsE,CAAC;iBACnF;gBACD;oBACE,IAAI,EAAE,sBAAsB;oBAC5B,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,uEAAuE,CAAC;iBACpF;gBACD;oBACE,IAAI,EAAE,mBAAmB;oBACzB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,oEAAoE,CAAC;iBACjF;aACF;SACF;QACD;YACE,IAAI,EAAE,wBAAwB;YAC9B,aAAa,EAAE,YAAY;YAC3B,WAAW,EAAE,mCAAmC;YAChD,OAAO,EAAE,IAAI;YACb,kEAAkE;YAClE,kEAAkE;YAClE,+DAA+D;YAC/D,+DAA+D;YAC/D,4DAA4D;YAC5D,+DAA+D;YAC/D,+DAA+D;YAC/D,iDAAiD;YACjD,cAAc,EAAE;gBACd,iBAAiB;gBACjB,2BAA2B;gBAC3B,yBAAyB;gBACzB,gCAAgC;aACjC;YACD,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,kBAAkB;oBACxB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,sCAAsC,CAAC;iBACnD;gBACD;oBACE,IAAI,EAAE,gBAAgB;oBACtB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,oCAAoC,CAAC;iBACjD;gBACD;oBACE,IAAI,EAAE,uBAAuB;oBAC7B,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,2CAA2C,CAAC;iBACxD;aACF;SACF;QACD;YACE,IAAI,EAAE,kBAAkB;YACxB,aAAa,EAAE,cAAc;YAC7B,WAAW,EAAE,qBAAqB;YAClC,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,kBAAkB;oBACxB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,kDAAkD,CAAC;iBAC/D;gBACD;oBACE,IAAI,EAAE,gBAAgB;oBACtB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,gDAAgD,CAAC;iBAC7D;gBACD;oBACE,IAAI,EAAE,uBAAuB;oBAC7B,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,uDAAuD,CAAC;iBACpE;gBACD,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,iCAAiC,CAAC,EAAE;aACzF;SACF;QACD;YACE,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,qCAAqC;YAClD,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,kBAAkB;oBACxB,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,CAAC,kCAAkC,CAAC;iBAC/C;gBACD,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,6BAA6B,CAAC,EAAE;gBACnF,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,4BAA4B,CAAC,EAAE;aAClF;SACF;KACF,CAAA;AACH,CAAC"}

package/dist/detection/feature-flag.d.ts

@@ -1,3 +1,25 @@
+/**
+ * How sure we are this is really a feature flag callsite.
+ *
+ *   - **high**: Detected through a strict import-gated SDK match. False
+ *     positives are very rare; the SDK package is statically imported and
+ *     the call shape matches the provider's declared method exactly. Safe
+ *     for auto-merge cleanup PRs.
+ *
+ *   - **medium**: Detected through a weaker signal — a runtime-symbol
+ *     gate bypass (`window.posthog` etc.), an unambiguous-method-name
+ *     match without an import, or a user-configured custom detector.
+ *     The flag is almost certainly real but the gate is wider. Suggested
+ *     handling: surface to humans for review, don't auto-merge.
+ *
+ *   - **low**: Reserved for the future static-config flag system
+ *     detector (B3 auto-discovery slice — not shipped today). Heuristic
+ *     match with weaker precision; recommend manual confirmation.
+ *
+ * Absent / undefined is equivalent to `'high'` so existing consumers
+ * that don't read the field keep their current behaviour.
+ */
+export type FlagConfidence = 'high' | 'medium' | 'low';
 /**
  * Represents a detected feature flag in source code.
  */
@@ -12,5 +34,11 @@ export interface FeatureFlag {
     language: string;
     /** SDK/library provider if detected (e.g., "launchdarkly") */
     provider?: string;
+    /**
+     * Detection-quality tier. See FlagConfidence's docstring for what each
+     * value means. Absent = `'high'` (the historical default, preserves
+     * behaviour for consumers that haven't been updated yet).
+     */
+    confidence?: FlagConfidence;
 }
 //# sourceMappingURL=feature-flag.d.ts.map

package/dist/detection/feature-flag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flag.d.ts","sourceRoot":"","sources":["../../src/detection/feature-flag.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAA;IAChB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB"}
+{"version":3,"file":"feature-flag.d.ts","sourceRoot":"","sources":["../../src/detection/feature-flag.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;AAEtD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAA;IAChB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,cAAc,CAAA;CAC5B"}

package/dist/detection/helpers.d.ts

@@ -41,6 +41,22 @@ export declare function escapeRegExp(str: string): string;
  * This is used by all language detectors as the primary detection mechanism.
  */
 export declare function detectFlagsWithRegex(filename: string, content: string, language: Language, providers: FeatureFlagProvider[]): FeatureFlag[];
+/**
+ * Extracts flag keys from destructured property names on a hook's return
+ * value. Handles the LaunchDarkly React SDK pattern (and any future hook
+ * with the same shape):
+ *
+ *   const { showNewCheckout, oneClickPurchase } = useFlags()
+ *   let   { feature: aliased } = useFlags()  // takes `feature`, not `aliased`
+ *
+ * Multi-line destructures are supported (the regex spans newlines). The
+ * line number reported is the line where the destructure begins.
+ *
+ * Identifiers that fail `isValidFlagKey` (numeric literals, reserved
+ * words) are dropped — this is the same gate the positional-arg path
+ * applies, kept consistent so downstream consumers see one rule.
+ */
+export declare function detectDestructuredHookFlags(filename: string, content: string, language: Language, provider: string, hookName: string, confidence?: 'high' | 'medium'): FeatureFlag[];
 /** Checks whether a string looks like a valid feature flag key. */
 export declare function isValidFlagKey(key: string): boolean;
 /**

package/dist/detection/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/detection/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEjF,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAEpE;AAED,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAKlE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAapE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiCzF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA2DxD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAQpE;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,mBAAmB,EAAE,GAC/B,WAAW,EAAE,CAqEf;AAmDD,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAanD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,MAAM,EAAE,mBAAmB,EAAE,GAC5B,mBAAmB,EAAE,CAuBvB"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/detection/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEjF,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAEpE;AAED,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAKlE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAapE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiCzF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA2DxD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAQpE;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,mBAAmB,EAAE,GAC/B,WAAW,EAAE,CAsHf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,MAAM,GAAG,QAAiB,GACrC,WAAW,EAAE,CAoCf;AAkED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAqBnD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,MAAM,EAAE,mBAAmB,EAAE,GAC5B,mBAAmB,EAAE,CAuBvB"}

package/dist/detection/helpers.js

@@ -155,12 +155,33 @@ export function detectFlagsWithRegex(filename, content, language, providers) {
         }
         const providerName = provider.name;
         const importPat = getImportPattern(provider);
-        // Import check: skip this provider if file doesn't import its SDK.
-        // Providers with no importPattern (e.g., "Custom Feature Flags") are kept as fallbacks.
+        // Import gate: skip this provider if the file doesn't import its SDK,
+        // UNLESS it carries a runtime-symbol that flags the SDK as present even
+        // without a static import. Providers with no importPattern (the legacy
+        // "Custom Feature Flags" catch-all) always run.
+        //
+        // Detected via runtimeSymbols are tagged below with `confidence: 'medium'`
+        // so downstream consumers can route them through review rather than
+        // auto-merge. See B2 design doc + the provider docstring for the
+        // false-positive trade-off.
+        let detectionConfidence = 'high';
         if (importPat) {
-            const hasImport = content.includes(importPat) || lines.some((line) => line.includes(importPat));
+            // The import gate passes if EITHER the primary pattern OR any
+            // declared alias is present in the file. SDKs republished under a
+            // scoped name (e.g. `@launchdarkly/react-client-sdk`) rely on the
+            // alias list so the legacy unscoped form
+            // (`launchdarkly-react-client-sdk`) still triggers detection.
+            const importPatterns = [importPat, ...(provider.importAliases ?? [])];
+            const hasImport = importPatterns.some((pat) => content.includes(pat) || lines.some((line) => line.includes(pat)));
             if (!hasImport) {
-                continue;
+                // Check whether the file matches any runtime-symbol pattern.
+                const runtimeHit = (provider.runtimeSymbols ?? []).some((sym) => content.includes(sym));
+                if (!runtimeHit) {
+                    continue;
+                }
+                // Gate passed via runtime symbol — downgrade confidence so the
+                // flag's downstream treatment reflects the weaker signal.
+                detectionConfidence = 'medium';
             }
         }
         for (const method of provider.methods) {
@@ -189,20 +210,89 @@ export function detectFlagsWithRegex(filename, content, language, providers) {
                     }
                     const flagKey = extractStringArgument(restOfContent, method.flagKeyIndex);
                     if (flagKey && isValidFlagKey(flagKey)) {
-                        flags.push({
+                        const flag = {
                             name: flagKey,
                             filePath: filename,
                             lineNumber: lineIdx + 1,
                             language,
                             provider: importPat || providerName,
-                        });
+                        };
+                        // Only emit `confidence` when it's a non-default value. The
+                        // FeatureFlag type documents `confidence` as optional with
+                        // "absent = high", so omitting it for the common case keeps
+                        // existing JSON consumers + test fixtures stable.
+                        if (detectionConfidence !== 'high')
+                            flag.confidence = detectionConfidence;
+                        flags.push(flag);
                     }
                 }
             }
         }
+        // useFlagsHook: providers like the LaunchDarkly React SDK don't pass
+        // flag keys as call-site arguments. Instead, calling `useFlags()` returns
+        // an object whose keys ARE the flag names; consumers either destructure
+        // them or index into them. The positional-arg pipeline above can't see
+        // this shape. When a provider declares `useFlagsHook`, run a second pass
+        // that extracts destructured property names from `... = <hook>()` sites
+        // and emits each as a detected flag.
+        if (provider.useFlagsHook) {
+            const hookFlags = detectDestructuredHookFlags(filename, content, language, importPat || providerName, provider.useFlagsHook, detectionConfidence);
+            flags.push(...hookFlags);
+        }
     }
     return deduplicateFlags(flags);
 }
+/**
+ * Extracts flag keys from destructured property names on a hook's return
+ * value. Handles the LaunchDarkly React SDK pattern (and any future hook
+ * with the same shape):
+ *
+ *   const { showNewCheckout, oneClickPurchase } = useFlags()
+ *   let   { feature: aliased } = useFlags()  // takes `feature`, not `aliased`
+ *
+ * Multi-line destructures are supported (the regex spans newlines). The
+ * line number reported is the line where the destructure begins.
+ *
+ * Identifiers that fail `isValidFlagKey` (numeric literals, reserved
+ * words) are dropped — this is the same gate the positional-arg path
+ * applies, kept consistent so downstream consumers see one rule.
+ */
+export function detectDestructuredHookFlags(filename, content, language, provider, hookName, confidence = 'high') {
+    const out = [];
+    const pattern = new RegExp(`(?:const|let|var)\\s*\\{\\s*([\\s\\S]*?)\\}\\s*=\\s*${escapeRegExp(hookName)}\\s*\\(\\s*\\)`, 'g');
+    let m;
+    while ((m = pattern.exec(content)) !== null) {
+        const lineNumber = content.slice(0, m.index).split('\n').length;
+        const inside = m[1];
+        // Strip line comments inside the destructure body before splitting on
+        // commas — otherwise a trailing `// note` would taint the last name.
+        const cleaned = inside
+            .split('\n')
+            .map((seg) => seg.replace(/\/\/.*$/, ''))
+            .join(' ');
+        for (const raw of cleaned.split(',')) {
+            const trimmed = raw.trim();
+            if (!trimmed)
+                continue;
+            // `originalName: alias` — the flag key is the SOURCE side (the
+            // property on the hook's return value), not the local alias.
+            const flagKey = trimmed.split(':')[0].trim();
+            if (isValidFlagKey(flagKey)) {
+                const flag = {
+                    name: flagKey,
+                    filePath: filename,
+                    lineNumber,
+                    language,
+                    provider,
+                };
+                if (confidence !== 'high')
+                    flag.confidence = confidence;
+                out.push(flag);
+            }
+        }
+    }
+    return out;
+}
 /** Builds a regex for a single method name that matches calls. */
 function buildSingleMethodPattern(methodName) {
     const escaped = escapeRegExp(methodName);
@@ -249,6 +339,20 @@ function getCallExpression(lines, startLine, startCol) {
     /* v8 ignore next -- foundOpen is always true here: the matching regex requires '(' which startCol points to */
     return foundOpen ? result : null;
 }
+/**
+ * Characters that legitimate feature flag keys never contain. Real keys
+ * across LaunchDarkly, Unleash, PostHog, Statsig, Split.io, and the
+ * shakedown corpus are limited to letters, digits, underscores, dashes,
+ * dots, and colons. The chars below appear only when we've accidentally
+ * latched onto a regex literal, a URL fragment, or a string with parens.
+ *
+ * Surfaced by the PostHog shakedown: a TSX file contained the regex
+ * fragment `([^/]+)` which slipped through `isValidFlagKey` because the
+ * legacy check only rejected URL prefixes. The new key now reports as a
+ * false positive in flagshark's output — that's the bug this set guards
+ * against. See A2 in the shakedown bug inventory.
+ */
+const INVALID_FLAG_KEY_CHAR = /[()\[\]^$\\\s]/;
 /** Checks whether a string looks like a valid feature flag key. */
 export function isValidFlagKey(key) {
     if (key.length === 0 || key.length > 256) {
@@ -260,6 +364,13 @@ export function isValidFlagKey(key) {
             return false;
         }
     }
+    // Reject keys that look like regex literals, character classes, or contain
+    // whitespace — none of these are legitimate shapes for a feature flag key
+    // and they consistently indicate we've extracted the wrong string from a
+    // method call (e.g. `new RegExp('([^/]+)')` getting matched).
+    if (INVALID_FLAG_KEY_CHAR.test(key)) {
+        return false;
+    }
     return true;
 }
 /**