@flagshark/core 1.0.0

package/dist/detection/detectors/php.js

@@ -0,0 +1,210 @@
+/**
+ * PHP language feature flag detector.
+ * Ported from Go: internal/languages/php/detector.go
+ */
+import { detectFlagsWithRegex } from '../helpers.js';
+import { Languages } from '../interface.js';
+export class PHPDetector {
+    providers;
+    constructor(providers) {
+        this.providers = providers ?? defaultPHPProviders();
+    }
+    language() {
+        return Languages.PHP;
+    }
+    fileExtensions() {
+        return ['.php', '.phtml', '.php3', '.php4', '.php5', '.phps'];
+    }
+    supportsFile(filename) {
+        const ext = filename.toLowerCase().split('.').pop();
+        return ['php', 'phtml', 'php3', 'php4', 'php5', 'phps'].includes(ext ?? '');
+    }
+    detectFlags(filename, content) {
+        return detectFlagsWithRegex(filename, content, this.language(), this.providers);
+    }
+    getProviders() {
+        return this.providers;
+    }
+}
+export function defaultPHPProviders() {
+    return [
+        {
+            name: 'LaunchDarkly PHP SDK',
+            importPattern: 'LaunchDarkly\\',
+            description: 'LaunchDarkly PHP SDK',
+            enabled: true,
+            methods: [
+                {
+                    name: 'variation',
+                    flagKeyIndex: 0,
+                    examples: ['$client->variation("flag-key", $context, false)'],
+                },
+                {
+                    name: 'boolVariation',
+                    flagKeyIndex: 0,
+                    examples: ['$client->boolVariation("flag-key", $context, false)'],
+                },
+                {
+                    name: 'stringVariation',
+                    flagKeyIndex: 0,
+                    examples: ['$client->stringVariation("flag-key", $context, "default")'],
+                },
+                {
+                    name: 'intVariation',
+                    flagKeyIndex: 0,
+                    examples: ['$client->intVariation("flag-key", $context, 0)'],
+                },
+                {
+                    name: 'floatVariation',
+                    flagKeyIndex: 0,
+                    examples: ['$client->floatVariation("flag-key", $context, 0.0)'],
+                },
+                {
+                    name: 'jsonVariation',
+                    flagKeyIndex: 0,
+                    examples: ['$client->jsonVariation("flag-key", $context, [])'],
+                },
+            ],
+        },
+        {
+            name: 'Unleash PHP SDK',
+            importPattern: 'Unleash\\Client',
+            description: 'Unleash PHP SDK',
+            enabled: true,
+            methods: [
+                { name: 'isEnabled', flagKeyIndex: 0, examples: ['$unleash->isEnabled("feature-toggle")'] },
+                {
+                    name: 'getVariant',
+                    flagKeyIndex: 0,
+                    examples: ['$unleash->getVariant("feature-toggle")'],
+                },
+            ],
+        },
+        {
+            name: 'Split.io PHP SDK',
+            importPattern: 'SplitIO\\',
+            description: 'Split.io PHP SDK',
+            enabled: true,
+            methods: [
+                {
+                    name: 'getTreatment',
+                    flagKeyIndex: 1,
+                    examples: ['$client->getTreatment($key, "split-name")'],
+                },
+                {
+                    name: 'getTreatments',
+                    flagKeyIndex: 1,
+                    examples: ['$client->getTreatments($key, ["split1", "split2"])'],
+                },
+            ],
+        },
+        {
+            name: 'Flagsmith PHP SDK',
+            importPattern: 'Flagsmith\\',
+            description: 'Flagsmith PHP SDK',
+            enabled: true,
+            methods: [
+                {
+                    name: 'isFeatureEnabled',
+                    flagKeyIndex: 0,
+                    examples: ['$flags->isFeatureEnabled("feature-name")'],
+                },
+                {
+                    name: 'getFeatureValue',
+                    flagKeyIndex: 0,
+                    examples: ['$flags->getFeatureValue("feature-name")'],
+                },
+            ],
+        },
+        {
+            name: 'ConfigCat PHP SDK',
+            importPattern: 'ConfigCat\\',
+            description: 'ConfigCat PHP SDK',
+            enabled: true,
+            methods: [
+                { name: 'getValue', flagKeyIndex: 0, examples: ['$client->getValue("flag-key", false)'] },
+            ],
+        },
+        {
+            name: 'Statsig PHP SDK',
+            importPattern: 'Statsig\\',
+            description: 'Statsig PHP SDK',
+            enabled: true,
+            methods: [
+                {
+                    name: 'checkGate',
+                    flagKeyIndex: 1,
+                    examples: ['Statsig::checkGate($user, "gate-name")'],
+                },
+                {
+                    name: 'getExperiment',
+                    flagKeyIndex: 1,
+                    examples: ['Statsig::getExperiment($user, "experiment-name")'],
+                },
+                {
+                    name: 'getConfig',
+                    flagKeyIndex: 1,
+                    examples: ['Statsig::getConfig($user, "config-name")'],
+                },
+            ],
+        },
+        {
+            name: 'GrowthBook PHP SDK',
+            importPattern: 'Growthbook\\',
+            description: 'GrowthBook PHP SDK',
+            enabled: true,
+            methods: [
+                { name: 'isOn', flagKeyIndex: 0, examples: ['$gb->isOn("feature-key")'] },
+                {
+                    name: 'getFeatureValue',
+                    flagKeyIndex: 0,
+                    examples: ['$gb->getFeatureValue("feature-key", $fallbackValue)'],
+                },
+            ],
+        },
+        {
+            name: 'PostHog PHP SDK',
+            importPattern: 'PostHog\\',
+            description: 'PostHog PHP SDK',
+            enabled: true,
+            methods: [
+                {
+                    name: 'isFeatureEnabled',
+                    flagKeyIndex: 0,
+                    examples: ['PostHog::isFeatureEnabled("flag-key", $distinctId)'],
+                },
+                {
+                    name: 'getFeatureFlag',
+                    flagKeyIndex: 0,
+                    examples: ['PostHog::getFeatureFlag("flag-key", $distinctId)'],
+                },
+            ],
+        },
+        {
+            name: 'Laravel Pennant',
+            importPattern: 'Laravel\\Pennant',
+            description: 'Laravel Pennant feature flags',
+            enabled: true,
+            methods: [
+                { name: 'active', flagKeyIndex: 0, examples: ['Feature::active("feature-name")'] },
+                { name: 'inactive', flagKeyIndex: 0, examples: ['Feature::inactive("feature-name")'] },
+                { name: 'value', flagKeyIndex: 0, examples: ['Feature::value("feature-name")'] },
+            ],
+        },
+        {
+            name: 'Custom Feature Flags',
+            description: 'Common custom PHP feature flag patterns',
+            enabled: true,
+            methods: [
+                {
+                    name: 'isFeatureEnabled',
+                    flagKeyIndex: 0,
+                    examples: ['isFeatureEnabled("feature-name")'],
+                },
+                { name: 'feature_enabled', flagKeyIndex: 0, examples: ['feature_enabled("feature-name")'] },
+                { name: 'hasFeature', flagKeyIndex: 0, examples: ['hasFeature("feature-name")'] },
+            ],
+        },
+    ];
+}
+//# sourceMappingURL=php.js.map

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

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

package/dist/detection/detectors/python.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Python language feature flag detector.
+ * Ported from Go: internal/languages/python/detector.go
+ */
+import type { FeatureFlag } from '../feature-flag.js';
+import type { FeatureFlagProvider, Language, LanguageDetector } from '../interface.js';
+export declare class PythonDetector implements LanguageDetector {
+    private readonly providers;
+    constructor(providers?: FeatureFlagProvider[]);
+    language(): Language;
+    fileExtensions(): string[];
+    supportsFile(filename: string): boolean;
+    detectFlags(filename: string, content: string): FeatureFlag[];
+    getProviders(): FeatureFlagProvider[];
+}
+export declare function defaultPythonProviders(): FeatureFlagProvider[];
+//# sourceMappingURL=python.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../../src/detection/detectors/python.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEtF,qBAAa,cAAe,YAAW,gBAAgB;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;gBAErC,SAAS,CAAC,EAAE,mBAAmB,EAAE;IAI7C,QAAQ,IAAI,QAAQ;IAIpB,cAAc,IAAI,MAAM,EAAE;IAI1B,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKvC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE;IAI7D,YAAY,IAAI,mBAAmB,EAAE;CAGtC;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,EAAE,CA8P9D"}

package/dist/detection/detectors/python.js

@@ -0,0 +1,284 @@
+/**
+ * Python language feature flag detector.
+ * Ported from Go: internal/languages/python/detector.go
+ */
+import { detectFlagsWithRegex } from '../helpers.js';
+import { Languages } from '../interface.js';
+export class PythonDetector {
+    providers;
+    constructor(providers) {
+        this.providers = providers ?? defaultPythonProviders();
+    }
+    language() {
+        return Languages.Python;
+    }
+    fileExtensions() {
+        return ['.py', '.pyw', '.pyx', '.pyi'];
+    }
+    supportsFile(filename) {
+        const ext = filename.toLowerCase().split('.').pop();
+        return ['py', 'pyw', 'pyx', 'pyi'].includes(ext ?? '');
+    }
+    detectFlags(filename, content) {
+        return detectFlagsWithRegex(filename, content, this.language(), this.providers);
+    }
+    getProviders() {
+        return this.providers;
+    }
+}
+export function defaultPythonProviders() {
+    return [
+        {
+            name: 'LaunchDarkly Python SDK',
+            importPattern: 'ldclient',
+            description: 'LaunchDarkly Python SDK',
+            enabled: true,
+            methods: [
+                {
+                    name: 'variation',
+                    flagKeyIndex: 0,
+                    examples: ['client.variation("flag-key", user, default_value)'],
+                },
+                {
+                    name: 'bool_variation',
+                    flagKeyIndex: 0,
+                    examples: ['client.bool_variation("flag-key", user, False)'],
+                },
+            ],
+        },
+        {
+            name: 'Unleash Python SDK',
+            importPattern: 'UnleashClient',
+            description: 'Unleash Python SDK',
+            enabled: true,
+            methods: [
+                { name: 'is_enabled', flagKeyIndex: 0, examples: ['unleash.is_enabled("feature-toggle")'] },
+                {
+                    name: 'get_variant',
+                    flagKeyIndex: 0,
+                    examples: ['unleash.get_variant("feature-toggle")'],
+                },
+            ],
+        },
+        {
+            name: 'Split.io Python SDK',
+            importPattern: 'splitio',
+            description: 'Split.io Python SDK',
+            enabled: true,
+            methods: [
+                {
+                    name: 'get_treatment',
+                    flagKeyIndex: 1,
+                    examples: ['client.get_treatment(key, "split-name")'],
+                },
+            ],
+        },
+        {
+            name: 'Flipt Python SDK',
+            importPattern: 'flipt',
+            description: 'Flipt Python SDK',
+            enabled: true,
+            methods: [
+                {
+                    name: 'evaluate_boolean',
+                    flagKeyIndex: 0,
+                    examples: ['flipt.evaluate_boolean("flag-key", entity_id)'],
+                },
+                {
+                    name: 'evaluate_variant',
+                    flagKeyIndex: 0,
+                    examples: ['flipt.evaluate_variant("flag-key", entity_id)'],
+                },
+            ],
+        },
+        {
+            name: 'Django Feature Flags',
+            importPattern: 'django_feature_flags',
+            description: 'Django feature flags',
+            enabled: true,
+            methods: [
+                { name: 'flag_enabled', flagKeyIndex: 0, examples: ['flag_enabled("feature-name")'] },
+                { name: 'flag_disabled', flagKeyIndex: 0, examples: ['flag_disabled("feature-name")'] },
+            ],
+        },
+        {
+            name: 'Optimizely Python SDK',
+            importPattern: 'optimizely',
+            description: 'Optimizely Feature Experimentation Python SDK',
+            enabled: true,
+            methods: [
+                { name: 'decide', flagKeyIndex: 0, examples: ['user.decide("flag-key", options)'] },
+                {
+                    name: 'decide_for_keys',
+                    flagKeyIndex: 0,
+                    examples: ['user.decide_for_keys(["flag-key-1", "flag-key-2"], options)'],
+                },
+                { name: 'decide_all', flagKeyIndex: 0, examples: ['user.decide_all(options)'] },
+            ],
+        },
+        {
+            name: 'Flagsmith Python SDK',
+            importPattern: 'flagsmith',
+            description: 'Flagsmith Python SDK',
+            enabled: true,
+            methods: [
+                {
+                    name: 'is_feature_enabled',
+                    flagKeyIndex: 0,
+                    examples: ['identity_flags.is_feature_enabled("feature-name")'],
+                },
+                {
+                    name: 'get_feature_value',
+                    flagKeyIndex: 0,
+                    examples: ['identity_flags.get_feature_value("feature-name")'],
+                },
+            ],
+        },
+        {
+            name: 'ConfigCat Python SDK',
+            importPattern: 'configcatclient',
+            description: 'ConfigCat Python SDK',
+            enabled: true,
+            methods: [
+                {
+                    name: 'get_value',
+                    flagKeyIndex: 0,
+                    examples: ['client.get_value("flag-key", default_value)'],
+                },
+                {
+                    name: 'get_value_details',
+                    flagKeyIndex: 0,
+                    examples: ['client.get_value_details("flag-key", default_value)'],
+                },
+            ],
+        },
+        {
+            name: 'Statsig Python SDK',
+            importPattern: 'statsig',
+            description: 'Statsig Python SDK',
+            enabled: true,
+            methods: [
+                {
+                    name: 'check_gate',
+                    flagKeyIndex: 1,
+                    examples: ['statsig.check_gate(user, "gate-name")'],
+                },
+                {
+                    name: 'get_experiment',
+                    flagKeyIndex: 1,
+                    examples: ['statsig.get_experiment(user, "experiment-name")'],
+                },
+                {
+                    name: 'get_config',
+                    flagKeyIndex: 1,
+                    examples: ['statsig.get_config(user, "config-name")'],
+                },
+            ],
+        },
+        {
+            name: 'GrowthBook Python SDK',
+            importPattern: 'growthbook',
+            description: 'GrowthBook Python SDK',
+            enabled: true,
+            methods: [
+                { name: 'is_on', flagKeyIndex: 0, examples: ['gb.is_on("feature-key")'] },
+                {
+                    name: 'get_feature_value',
+                    flagKeyIndex: 0,
+                    examples: ['gb.get_feature_value("feature-key", fallback_value)'],
+                },
+                { name: 'eval_feature', flagKeyIndex: 0, examples: ['gb.eval_feature("feature-key")'] },
+            ],
+        },
+        {
+            name: 'DevCycle Python SDK',
+            importPattern: 'devcycle_python_sdk',
+            description: 'DevCycle Python SDK',
+            enabled: true,
+            methods: [
+                {
+                    name: 'variable_value',
+                    flagKeyIndex: 1,
+                    examples: ['client.variable_value(user, "variable-key", default_value)'],
+                },
+                {
+                    name: 'variable',
+                    flagKeyIndex: 1,
+                    examples: ['client.variable(user, "variable-key", default_value)'],
+                },
+            ],
+        },
+        {
+            name: 'Eppo Python SDK',
+            importPattern: 'eppo_client',
+            description: 'Eppo Python SDK',
+            enabled: true,
+            methods: [
+                {
+                    name: 'get_boolean_assignment',
+                    flagKeyIndex: 0,
+                    examples: ['eppo_client.get_boolean_assignment("flag-key", subject_key, default_value)'],
+                },
+                {
+                    name: 'get_string_assignment',
+                    flagKeyIndex: 0,
+                    examples: ['eppo_client.get_string_assignment("flag-key", subject_key, default_value)'],
+                },
+                {
+                    name: 'get_numeric_assignment',
+                    flagKeyIndex: 0,
+                    examples: ['eppo_client.get_numeric_assignment("flag-key", subject_key, default_value)'],
+                },
+                {
+                    name: 'get_json_assignment',
+                    flagKeyIndex: 0,
+                    examples: ['eppo_client.get_json_assignment("flag-key", subject_key, default_value)'],
+                },
+            ],
+        },
+        {
+            name: 'PostHog Python SDK',
+            importPattern: 'posthog',
+            description: 'PostHog Python SDK',
+            enabled: true,
+            methods: [
+                {
+                    name: 'feature_enabled',
+                    flagKeyIndex: 0,
+                    examples: ['posthog.feature_enabled("flag-key", distinct_id)'],
+                },
+                {
+                    name: 'get_feature_flag',
+                    flagKeyIndex: 0,
+                    examples: ['posthog.get_feature_flag("flag-key", distinct_id)'],
+                },
+                {
+                    name: 'get_feature_flag_payload',
+                    flagKeyIndex: 0,
+                    examples: ['posthog.get_feature_flag_payload("flag-key", distinct_id)'],
+                },
+                {
+                    name: 'get_all_flags',
+                    flagKeyIndex: 0,
+                    examples: ['posthog.get_all_flags(distinct_id)'],
+                },
+            ],
+        },
+        {
+            name: 'Custom Feature Flags',
+            description: 'Common custom Python feature flag patterns',
+            enabled: true,
+            methods: [
+                {
+                    name: 'is_feature_enabled',
+                    flagKeyIndex: 0,
+                    examples: ['is_feature_enabled("feature-name")'],
+                },
+                { name: 'feature_flag', flagKeyIndex: 0, examples: ['feature_flag("feature-name")'] },
+                { name: 'has_feature', flagKeyIndex: 0, examples: ['has_feature("feature-name")'] },
+                { name: 'check_feature', flagKeyIndex: 0, examples: ['check_feature("feature-name")'] },
+            ],
+        },
+    ];
+}
+//# sourceMappingURL=python.js.map

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

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

package/dist/detection/detectors/ruby.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Ruby language feature flag detector.
+ * Ported from Go: internal/languages/ruby/detector.go
+ */
+import type { FeatureFlag } from '../feature-flag.js';
+import type { FeatureFlagProvider, Language, LanguageDetector } from '../interface.js';
+export declare class RubyDetector implements LanguageDetector {
+    private readonly providers;
+    constructor(providers?: FeatureFlagProvider[]);
+    language(): Language;
+    fileExtensions(): string[];
+    supportsFile(filename: string): boolean;
+    detectFlags(filename: string, content: string): FeatureFlag[];
+    getProviders(): FeatureFlagProvider[];
+}
+export declare function defaultRubyProviders(): FeatureFlagProvider[];
+//# sourceMappingURL=ruby.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ruby.d.ts","sourceRoot":"","sources":["../../../src/detection/detectors/ruby.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEtF,qBAAa,YAAa,YAAW,gBAAgB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;gBAErC,SAAS,CAAC,EAAE,mBAAmB,EAAE;IAI7C,QAAQ,IAAI,QAAQ;IAIpB,cAAc,IAAI,MAAM,EAAE;IAI1B,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAWvC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE;IAI7D,YAAY,IAAI,mBAAmB,EAAE;CAGtC;AAED,wBAAgB,oBAAoB,IAAI,mBAAmB,EAAE,CA+N5D"}