@flagshark/core 1.5.0 → 2.1.0

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;
 }
 /**

package/dist/detection/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/detection/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAKjD,yDAAyD;AACzD,MAAM,UAAU,kBAAkB,CAAC,OAAuB;IACxD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AACnC,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,kBAAkB,CAAC,OAAuB;IACxD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,CAAA;IAChC,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,MAAM,GAAkB,EAAE,CAAA;IAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAA;QAC9D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACb,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACnB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,UAAkB;IACxE,+BAA+B;IAC/B,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACxC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IAC1C,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAA;IACxD,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;IAEpC,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAA;IAEjC,gFAAgF;IAChF,2EAA2E;IAC3E,6EAA6E;IAC7E,gBAAgB;IAChB,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAA;IAChD,IAAI,UAAU,EAAE,CAAC;QACf,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAC5B,CAAC;IAED,qDAAqD;IACrD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAA;IAC3C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,OAAO,GAAG,EAAE,CAAA;IAChB,IAAI,QAAQ,GAAkB,IAAI,CAAA;IAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;QACrB,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAExC,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,IAAI,EAAE,CAAA;YACb,IAAI,EAAE,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBACrC,QAAQ,GAAG,IAAI,CAAA;YACjB,CAAC;YACD,SAAQ;QACV,CAAC;QAED,gCAAgC;QAChC,IAAI,EAAE,KAAK,GAAG,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;YACxC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;gBACf,CAAC,GAAG,GAAG,GAAG,CAAC,CAAA;gBACX,SAAQ;YACV,CAAC;QACH,CAAC;QAED,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAC3C,QAAQ,GAAG,EAAE,CAAA;YACb,OAAO,IAAI,EAAE,CAAA;YACb,SAAQ;QACV,CAAC;QAED,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAC3C,KAAK,EAAE,CAAA;YACP,OAAO,IAAI,EAAE,CAAA;YACb,SAAQ;QACV,CAAC;QAED,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAC3C,KAAK,EAAE,CAAA;YACP,OAAO,IAAI,EAAE,CAAA;YACb,SAAQ;QACV,CAAC;QAED,IAAI,EAAE,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YAClB,OAAO,GAAG,EAAE,CAAA;YACZ,SAAQ;QACV,CAAC;QAED,OAAO,IAAI,EAAE,CAAA;IACf,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACpB,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAqB;IAC1D,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAA,CAAC,gBAAgB;IAChC,CAAC;IACD,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;IACvD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACrC,gEAAgE;IAChE,OAAO,IAAI,MAAM,CAAC,+BAA+B,WAAW,UAAU,EAAE,IAAI,CAAC,CAAA;AAC/E,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,OAAe,EACf,QAAkB,EAClB,SAAgC;IAEhC,MAAM,KAAK,GAAkB,EAAE,CAAA;IAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAEjC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,SAAQ;QACV,CAAC;QACD,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,SAAQ;QACV,CAAC;QAED,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAA;QAClC,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QAE5C,mEAAmE;QACnE,wFAAwF;QACxF,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,SAAS,GACb,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAA;YAC/E,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,SAAQ;YACV,CAAC;QACH,CAAC;QAED,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtC,yDAAyD;YACzD,IAAI,MAAM,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;gBAC5B,SAAQ;YACV,CAAC;YAED,MAAM,OAAO,GAAG,wBAAwB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YAErD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;gBACxD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAA;gBAC3B,IAAI,KAA6B,CAAA;gBAEjC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;oBAC7C,+DAA+D;oBAC/D,gEAAgE;oBAChE,+DAA+D;oBAC/D,iEAAiE;oBACjE,iEAAiE;oBACjE,8DAA8D;oBAC9D,6DAA6D;oBAC7D,kEAAkE;oBAClE,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;oBACnD,MAAM,aAAa,GAAG,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;oBAClE,uIAAuI;oBACvI,IAAI,CAAC,aAAa,EAAE,CAAC;wBACnB,SAAQ;oBACV,CAAC;oBAED,MAAM,OAAO,GAAG,qBAAqB,CAAC,aAAa,EAAE,MAAM,CAAC,YAAY,CAAC,CAAA;oBACzE,IAAI,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;wBACvC,KAAK,CAAC,IAAI,CAAC;4BACT,IAAI,EAAE,OAAO;4BACb,QAAQ,EAAE,QAAQ;4BAClB,UAAU,EAAE,OAAO,GAAG,CAAC;4BACvB,QAAQ;4BACR,QAAQ,EAAE,SAAS,IAAI,YAAY;yBACpC,CAAC,CAAA;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAA;AAChC,CAAC;AAED,kEAAkE;AAClE,SAAS,wBAAwB,CAAC,UAAkB;IAClD,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,CAAA;IACxC,OAAO,IAAI,MAAM,CAAC,4BAA4B,OAAO,SAAS,EAAE,GAAG,CAAC,CAAA;AACtE,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,KAAe,EAAE,SAAiB,EAAE,QAAgB;IAC7E,IAAI,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAC7C,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,SAAS,GAAG,KAAK,CAAA;IAErB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACtB,KAAK,EAAE,CAAA;YACP,SAAS,GAAG,IAAI,CAAA;QAClB,CAAC;aAAM,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAC7B,KAAK,EAAE,CAAA;YACP,IAAI,SAAS,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAC7B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACvD,KAAK,IAAI,OAAO,GAAG,SAAS,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC;QAChE,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAA;QAC3B,MAAM,IAAI,IAAI,GAAG,IAAI,CAAA;QACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBACpB,KAAK,EAAE,CAAA;gBACP,SAAS,GAAG,IAAI,CAAA;YAClB,CAAC;iBAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC3B,KAAK,EAAE,CAAA;gBACP,IAAI,SAAS,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;oBAC7B,OAAO,MAAM,CAAA;gBACf,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,+GAA+G;IAC/G,OAAO,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;AAClC,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACzC,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,CAAC,CAAA;IAC/D,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,QAA+B,EAC/B,MAA6B;IAE7B,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAA;IAC5B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAA;IAE3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QAC3C,IAAI,OAAO,EAAE,CAAC;YACZ,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;QAC3B,CAAC;IACH,CAAC;IAED,KAAK,MAAM,cAAc,IAAI,MAAM,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAA;QAChD,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAClC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,CAAC,GAAG,cAAc,CAAA;QAC9B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;YAC3B,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAC3C,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/detection/helpers.ts"],"names":[],"mappings":"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"}

package/dist/detection/import-graph.d.ts

@@ -0,0 +1,234 @@
+/**
+ * Lightweight import-graph builder for TS/JS files.
+ *
+ * Goal: extend the existing "file imports a known SDK" detection gate to cover
+ * the common case where consumer files reach the SDK through a local wrapper —
+ * an internal `flag-resolver.ts`, a Pinia store, a custom React hook, a re-export
+ * barrel, etc. Without this, real codebases that hide the SDK behind an
+ * abstraction silently report 0 flags (see the pre-launch shakedown notes:
+ * Unleash at 4 of 62, n8n at 0 of many).
+ *
+ * Design — three deliberate compromises in service of "ship soon and don't add
+ * false positives":
+ *
+ *   1. **Regex import extraction, not tree-sitter.** The existing analyzer
+ *      already parses each file once for flag detection; running a second
+ *      tree-sitter pass for imports would roughly double scan time on a large
+ *      monorepo. Three regexes cover ESM static imports, CJS require(), and
+ *      dynamic import() with >95% coverage of real-world syntax. The misses
+ *      (heavily multi-line imports, computed-string specifiers, etc.) only
+ *      cost us some recall — they never add false positives because the gate
+ *      still requires a *real* SDK string match downstream.
+ *
+ *   2. **Relative-path resolution only.** TypeScript path aliases
+ *      (`@/foo` via tsconfig.paths), workspace `@scope/pkg` resolution, and
+ *      package.json `exports` are out of scope. A user with path aliases will
+ *      hit the same blind spot as today; we document it. The right fix is to
+ *      read tsconfig.json and apply paths — separate workstream, not a Show HN
+ *      blocker.
+ *
+ *   3. **Reverse-reachability BFS from SDK-importing seeds.** We propagate
+ *      SDK provenance *away* from the SDK importers. A file is "in scope" iff
+ *      it transitively imports something that imports an SDK. Cycle-safe via
+ *      a "did the set actually grow?" check before requeueing — bounded
+ *      O(edges × seeds) in the worst case.
+ *
+ * The output is consumed by PolyglotAnalyzer, which uses it to mark
+ * wrapper-consumer files as SDK-positive *for the gating step only* — actual
+ * flag-key extraction still goes through the same per-provider patterns, so
+ * precision stays the same as direct-import detection.
+ */
+import { Languages, type Language } from './interface.js';
+/**
+ * Extracts every module specifier mentioned in a TS/JS file.
+ *
+ * @returns a deduplicated array of specifier strings, in the order first seen.
+ *   Order is not load-bearing for the graph algorithm but makes test fixtures
+ *   readable.
+ */
+export declare function extractImports(content: string): string[];
+/**
+ * Extracts every module specifier mentioned in a Python file. Returns each
+ * specifier verbatim (including leading dots for relative imports). The
+ * graph's seed-matching logic compares the bare module name (everything
+ * before the first dot, e.g. `posthog` from `posthog.client`) against the
+ * SDK seed list.
+ *
+ * Multi-import lines like `import a, b, c` are split into individual
+ * specifiers; deduplicated within a file.
+ */
+export declare function extractPythonImports(content: string): string[];
+/**
+ * Resolves a Python import specifier to a file path that exists in
+ * `fileSet`. Python relative imports use dot notation rather than `./`:
+ *   - `from . import x`     → same package as importer
+ *   - `from .utils import x` → sibling module `utils` in same package
+ *   - `from ..lib import x`  → parent package's `lib`
+ *   - `from .. import x`    → parent package's `__init__.py`
+ *
+ * Absolute imports (`from posthog.client import x`) are NOT resolved into
+ * the file map — they reference installed packages outside the repo. Those
+ * get matched against the SDK seed list separately.
+ *
+ * Returns null for absolute imports or unresolvable paths.
+ */
+export declare function resolvePythonImport(importerPath: string, specifier: string, fileSet: ReadonlySet<string>): string | null;
+/**
+ * Resolved tsconfig.json path aliases — `compilerOptions.baseUrl` plus the
+ * `compilerOptions.paths` map. Returned by `loadTsconfigAliases` and passed
+ * to `resolveImportPath` so transitive wrapper detection follows imports
+ * that go through tsconfig path mapping (e.g. `@/lib/featureFlags` →
+ * `src/lib/featureFlags`). Pre-fix this was a known recall gap on
+ * alias-heavy monorepos.
+ */
+export interface PathAliases {
+    /** Absolute path of the directory `paths` resolves against. */
+    baseUrl: string;
+    /**
+     * Each entry maps an alias key (with a trailing `/*` if any) to a list of
+     * candidate targets (also with their `/*`). Example tsconfig entry:
+     *
+     *   "paths": { "@/*": ["src/*"], "@lib/*": ["src/lib/*", "vendor/lib/*"] }
+     *
+     * stores as `{ "@/*": ["src/*"], "@lib/*": ["src/lib/*", "vendor/lib/*"] }`.
+     */
+    paths: Map<string, string[]>;
+}
+/**
+ * Finds the nearest tsconfig.json (or jsconfig.json) at or above `root` and
+ * parses `compilerOptions.baseUrl` + `compilerOptions.paths`. Returns null
+ * if no config exists, the config has no path aliases, or the file fails
+ * to parse.
+ *
+ * Intentional limitations (documented so the recall ceiling is honest):
+ *   - We do NOT follow `extends` chains. A tsconfig that inherits aliases
+ *     from a parent project won't have them resolved here. Real fix would
+ *     require a recursive resolver matching tsc's actual behaviour.
+ *   - We only look at the first matching tsconfig walking up from `root`.
+ *     Nested workspaces with distinct tsconfigs per package aren't handled
+ *     specially — the outermost one wins. Sufficient for the typical
+ *     "alias is in repo-root tsconfig" pattern.
+ */
+export declare function loadTsconfigAliases(root: string): PathAliases | null;
+/**
+ * Tries to apply tsconfig path aliases to a bare-spec import. Returns the
+ * resolved absolute file path (if it exists in `fileSet`) or null.
+ *
+ * Two alias shapes are supported, matching tsc:
+ *   - Wildcard: key ends with `/*`, target ends with `/*`. The portion
+ *     after the alias prefix is substituted into the target wildcard.
+ *     Example: alias `@/*` → `src/*`; specifier `@/lib/foo` resolves to
+ *     `<baseUrl>/src/lib/foo`.
+ *   - Exact: no `*`. The specifier matches the alias exactly and resolves
+ *     to the literal target.
+ */
+export declare function resolveAliasedImport(specifier: string, aliases: PathAliases, fileSet: ReadonlySet<string>): string | null;
+/**
+ * Resolves a relative or absolute import specifier to a file path that exists
+ * in `fileSet`. Returns null for bare specifiers (unless `aliases` provided
+ * and the specifier matches an alias) or unresolvable paths.
+ *
+ * Resolution order matches Node + TS behavior closely enough for our purposes:
+ *   1. Path aliases (when `aliases` provided) — `@/foo` → `src/foo`.
+ *   2. Exact match (`./foo.ts`).
+ *   3. With each candidate extension (`./foo` → `./foo.ts`).
+ *   4. As a directory with `index.<ext>` (`./foo` → `./foo/index.ts`).
+ *   5. TS-emitted `.js` rewritten to `.ts` (`./foo.js` → `./foo.ts`), which
+ *      handles the verbatimModuleSyntax / NodeNext convention where TS source
+ *      writes `.js` but the actual file is `.ts`. Same for `.jsx`/`.tsx`.
+ */
+export declare function resolveImportPath(importerPath: string, specifier: string, fileSet: ReadonlySet<string>, aliases?: PathAliases): string | null;
+export interface ImportGraphOptions {
+    /**
+     * SDK package patterns that anchor the graph — typically the union of every
+     * provider's `importPattern` field across all enabled detectors
+     * (e.g. `['unleash-client', 'posthog-js', 'posthog-node', '@launchdarkly/...']`).
+     *
+     * A specifier counts as an SDK reference if it equals an entry exactly OR
+     * starts with `<entry>/` (handles SDK subpath imports like
+     * `launchdarkly-node-server-sdk/lib/foo`).
+     */
+    seedSdkPatterns: string[];
+    /**
+     * Returns whether a file path is a TS/JS source file the graph should walk.
+     * Used to skip Python/Go/etc. files in a polyglot file map without forcing
+     * callers to pre-filter.
+     */
+    /**
+     * Predicate that decides whether a file is in scope for the graph walk.
+     * Historically named `isTsJs` because TS/JS was the only supported
+     * surface — Python wrapper detection (B4) added .py to the in-scope
+     * set, and the implementation now dispatches extraction by extension
+     * inside the loop. The name is kept for back-compat; callers can pass
+     * `isScannedSourceFile` (which returns true for TS/JS + Python) when
+     * they want polyglot coverage, or `isTsJsFile` for TS/JS-only.
+     */
+    isTsJs(filePath: string): boolean;
+    /**
+     * Optional tsconfig path aliases (returned by `loadTsconfigAliases`).
+     * When provided, `@/foo`-style imports are followed during the
+     * transitive expansion; without it, those imports stop at the alias
+     * boundary and wrapper detection under-counts. Documented recall
+     * limitation pre-fix.
+     *
+     * Path aliases apply only to TS/JS files; Python imports never route
+     * through tsconfig.
+     */
+    aliases?: PathAliases;
+}
+export interface ImportGraphResult {
+    /**
+     * For each file in the input map (TS/JS only), the set of seed SDKs it
+     * reaches — directly or transitively through 1-N hops of relative imports.
+     * Files with no SDK reach are absent from the map (not present as empty set).
+     */
+    transitiveSdks: Map<string, Set<string>>;
+    /** Diagnostics — useful for tests and to surface in --verbose output later. */
+    stats: {
+        /** TS/JS files walked. */
+        filesWalked: number;
+        /** Files that directly import at least one seed SDK. */
+        seedFiles: number;
+        /** Files in transitiveSdks (seedFiles + wrappers + transitive consumers). */
+        inScopeFiles: number;
+        /** Relative-import edges resolved successfully. */
+        edgesResolved: number;
+        /** Relative-import edges that couldn't be resolved to a file in the input. */
+        edgesUnresolved: number;
+    };
+}
+/**
+ * Builds the transitive SDK-reach map for a set of TS/JS files.
+ *
+ * Algorithm:
+ *   1. Walk every TS/JS file, extract module specifiers.
+ *   2. For each specifier: if it's a seed SDK → record direct SDK reach;
+ *      if it's a relative path that resolves in the file map → add forward edge.
+ *   3. Build the reverse adjacency map (target → importers).
+ *   4. Seed the worklist with every directly-importing file. BFS outward
+ *      through the reverse graph, propagating each importer's SDK set
+ *      (union of all reachable importees). Requeue only when a set actually
+ *      grew — this terminates on every cyclic import graph.
+ */
+export declare function buildImportGraph(files: ReadonlyMap<string, string>, opts: ImportGraphOptions): ImportGraphResult;
+/**
+ * Returns true when the file path is a TS/JS source flagshark would parse.
+ * Mirrors the file-extension set used by TypeScriptDetector / JavaScriptDetector.
+ */
+/**
+ * True if the file is a Python source file the graph should walk.
+ * Mirrors the extension list of the Python detector — keep in sync.
+ */
+export declare function isPythonFile(filePath: string): boolean;
+/**
+ * Polyglot scope predicate: true for TS/JS *and* Python source files.
+ * Pass this as `ImportGraphOptions.isTsJs` when you want the graph to
+ * walk Python wrappers too. Replaces the TS/JS-only check incrementally
+ * without forcing every caller to update.
+ */
+export declare function isScannedSourceFile(filePath: string): boolean;
+export declare function isTsJsFile(filePath: string): boolean;
+export declare const _TS_JS_EXTENSIONS_FOR_TESTS: string[];
+export type { Language };
+export { Languages };
+//# sourceMappingURL=import-graph.d.ts.map

package/dist/detection/import-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-graph.d.ts","sourceRoot":"","sources":["../../src/detection/import-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAKH,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAyEzD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBxD;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAsB9D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAC3B,MAAM,GAAG,IAAI,CA6Bf;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAA;IACf;;;;;;;OAOG;IACH,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAkBpE;AAmFD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAC3B,MAAM,GAAG,IAAI,CA4Bf;AAmBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAC5B,OAAO,CAAC,EAAE,WAAW,GACpB,MAAM,GAAG,IAAI,CAkDf;AAID,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;OAQG;IACH,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB;;;;OAIG;IACH;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IACjC;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IACxC,+EAA+E;IAC/E,KAAK,EAAE;QACL,0BAA0B;QAC1B,WAAW,EAAE,MAAM,CAAA;QACnB,wDAAwD;QACxD,SAAS,EAAE,MAAM,CAAA;QACjB,6EAA6E;QAC7E,YAAY,EAAE,MAAM,CAAA;QACpB,mDAAmD;QACnD,aAAa,EAAE,MAAM,CAAA;QACrB,8EAA8E;QAC9E,eAAe,EAAE,MAAM,CAAA;KACxB,CAAA;CACF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,IAAI,EAAE,kBAAkB,GACvB,iBAAiB,CAuInB;AAID;;;GAGG;AACH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMpD;AAID,eAAO,MAAM,2BAA2B,UAAmB,CAAA;AAI3D,YAAY,EAAE,QAAQ,EAAE,CAAA;AACxB,OAAO,EAAE,SAAS,EAAE,CAAA"}