@ops-ai/svelte-feature-flags-toggly 1.0.0

package/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2024, Cosmin Atomei
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,431 @@
+Lightweight package that provides feature flags support for Svelte applications allowing you to check feature status and enable/disable them easily.
+
+Can be used *WITH* or *WITHOUT* [Toggly.io](https://toggly.io).
+
+## What is a Feature Flag
+
+A feature flag (or toggle) in software development provides an alternative to maintaining multiple feature branches in source code. A condition within the code enables or disables a feature during runtime.
+
+In agile settings the feature flag is used in production, to switch on the feature on demand, for some or all the users. Thus, feature flags make it easier to release often. Advanced roll out strategies such as canary roll out and A/B testing are easier to handle.
+
+## Installation
+
+Simply install using NPM to install this package.
+
+```shell
+$ npm i -s @ops-ai/svelte-feature-flags-toggly
+```
+
+## Basic Usage (with Toggly.io)
+
+### Initialize Toggly
+
+Import and initialize Toggly in your main application file (typically `App.svelte` or `main.ts`):
+
+```typescript
+import { createToggly } from '@ops-ai/svelte-feature-flags-toggly'
+
+// Initialize with your App Key & Environment name from your Toggly application page
+await createToggly({
+  appKey: 'your-app-key', // You can find this in app.toggly.io
+  environment: 'your-environment-name', // You can find this in app.toggly.io
+})
+```
+
+### Using the Feature Component
+
+Now you can start using the Feature component anywhere in your application:
+
+```svelte
+<script>
+  import { Feature } from '@ops-ai/svelte-feature-flags-toggly'
+</script>
+
+<Feature featureKey="firstFeature">
+  <p>This feature can be turned on or off.</p>
+</Feature>
+```
+
+### Feature Component Options
+
+You can also check multiple feature keys and make use of the *requirement* (all/any) and *negate* (bool) options (requirement is set to "all" by default).
+
+#### Show if all features are on
+
+```svelte
+<Feature featureKeys={['firstFeature', 'secondFeature']}>
+  <p>ALL the provided feature keys are TRUE.</p>
+</Feature>
+```
+
+#### Show if any feature is on
+
+```svelte
+<Feature featureKeys={['firstFeature', 'secondFeature']} requirement="any">
+  <p>AT LEAST ONE the provided feature keys is TRUE.</p>
+</Feature>
+```
+
+#### Show if features are off (negate)
+
+```svelte
+<Feature featureKeys={['firstFeature', 'secondFeature']} negate={true}>
+  <p>NONE of the provided feature keys is TRUE.</p>
+</Feature>
+```
+
+### Programmatic Feature Checks
+
+You can also check features programmatically using the store functions:
+
+```svelte
+<script>
+  import { isFeatureOn, isFeatureOff, evaluateFeatureGate } from '@ops-ai/svelte-feature-flags-toggly'
+  
+  let featureEnabled = false
+  
+  async function checkFeature() {
+    featureEnabled = await isFeatureOn('myFeature')
+  }
+  
+  async function checkMultipleFeatures() {
+    const result = await evaluateFeatureGate(['feature1', 'feature2'], 'any', false)
+    console.log('Gate result:', result)
+  }
+</script>
+
+<button on:click={checkFeature}>Check Feature</button>
+{#if featureEnabled}
+  <p>Feature is enabled!</p>
+{/if}
+```
+
+### Using Reactive Stores
+
+You can also use Svelte stores for reactive feature flag checks:
+
+```svelte
+<script>
+  import { createFeatureStore } from '@ops-ai/svelte-feature-flags-toggly'
+  
+  const myFeature = createFeatureStore('myFeature')
+</script>
+
+{#if $myFeature}
+  <p>Feature is enabled!</p>
+{/if}
+```
+
+## Users and Rollouts
+
+Using this package with [Toggly](https://toggly.io) allows you to define custom feature rollouts.
+
+Custom rollouts offers the ability to show features only to certain groups of users based on various custom rules which you can define in [Toggly](https://app.toggly.io).
+
+In case you want to support custom feature rollouts, remember to provide an unique identity string for each user to make sure they get the same feature values on future visits:
+
+```typescript
+await createToggly({
+  appKey: 'your-app-key', // You can find this in app.toggly.io
+  environment: 'your-environment-name', // You can find this in app.toggly.io
+  identity: 'unique-user-identifier', // Use this in case you want to support custom feature rollouts
+})
+```
+
+## Basic Usage (without Toggly.io)
+
+You can also use the Svelte SDK without connecting to Toggly.io by providing feature defaults:
+
+### Initialize with Defaults
+
+```typescript
+import { createToggly } from '@ops-ai/svelte-feature-flags-toggly'
+
+const featureDefaults = {
+  firstFeature: true,
+  secondFeature: false,
+}
+
+await createToggly({
+  featureDefaults: featureDefaults,
+})
+```
+
+Now you can use the Feature component the same way as with Toggly.io:
+
+```svelte
+<Feature featureKey="firstFeature">
+  <p>This feature can be turned on or off.</p>
+</Feature>
+```
+
+## Configuration Options
+
+The `createToggly` function accepts the following options:
+
+```typescript
+interface TogglyOptions {
+  baseURI?: string                    // Base URI for Toggly API (default: 'https://client.toggly.io')
+  appKey?: string                      // Your Toggly app key
+  environment?: string                  // Environment name (default: 'Production')
+  identity?: string                     // User identity for targeting
+  featureDefaults?: { [key: string]: boolean }  // Default feature values
+  showFeatureDuringEvaluation?: boolean // Show feature while evaluating (default: false)
+  featureFlagsRefreshInterval?: number // Cache refresh interval in ms (default: 180000)
+}
+```
+
+## TypeScript Support
+
+The Svelte SDK includes full TypeScript support with type definitions:
+
+```typescript
+import { 
+  Feature, 
+  createToggly, 
+  isFeatureOn,
+  type TogglyOptions 
+} from '@ops-ai/svelte-feature-flags-toggly'
+
+const config: TogglyOptions = {
+  appKey: 'your-app-key',
+  environment: 'Production',
+  identity: 'user-123'
+}
+
+await createToggly(config)
+```
+
+## SvelteKit Integration
+
+For SvelteKit applications, initialize Toggly in your root layout or a client-side component:
+
+```svelte
+<!-- src/routes/+layout.svelte -->
+<script>
+  import { onMount } from 'svelte'
+  import { createToggly } from '@ops-ai/svelte-feature-flags-toggly'
+  
+  onMount(async () => {
+    await createToggly({
+      appKey: 'your-app-key',
+      environment: 'Production',
+      identity: 'user-123' // Get from session/auth
+    })
+  })
+</script>
+
+<slot />
+```
+
+## Best Practices
+
+1. **Initialize Once**: Call `createToggly()` once at the root of your app
+2. **Use Feature Component**: Prefer using the Feature component for declarative feature flag checks
+3. **Provide User Context**: Include identity for accurate targeting and rollouts
+4. **Set Feature Defaults**: Provide defaults for offline scenarios or when not using Toggly.io
+5. **TypeScript**: Take advantage of TypeScript support for better type safety
+6. **Reactive Stores**: Use `createFeatureStore()` for reactive feature flag checks in your components
+
+## API Reference
+
+### `createToggly(config: TogglyOptions): Promise<void>`
+
+Initializes the Toggly service and loads feature flags.
+
+### `<Feature>`
+
+Svelte component for conditional rendering based on feature flags.
+
+**Props:**
+- `featureKey?: string` - Single feature key to check
+- `featureKeys?: string[]` - Multiple feature keys to check
+- `requirement?: 'all' | 'any'` - Requirement type (default: 'all')
+- `negate?: boolean` - Whether to negate the result (default: false)
+
+### `isFeatureOn(featureKey: string): Promise<boolean>`
+
+Check if a feature is enabled.
+
+### `isFeatureOff(featureKey: string): Promise<boolean>`
+
+Check if a feature is disabled.
+
+### `evaluateFeatureGate(featureKeys: string[], requirement?: 'all' | 'any', negate?: boolean): Promise<boolean>`
+
+Evaluate a feature gate with multiple flags.
+
+### `createFeatureStore(featureKey: string)`
+
+Create a reactive Svelte store for a specific feature flag.
+
+## Building the Library
+
+If you're contributing to or building this library from source:
+
+### Prerequisites
+
+- Node.js 18+ and npm
+- All dependencies installed
+
+### Build Steps
+
+1. **Install dependencies:**
+   ```bash
+   npm install
+   ```
+
+2. **Run type checking:**
+   ```bash
+   npm run typecheck
+   ```
+
+3. **Build the library:**
+   ```bash
+   npm run build
+   ```
+
+   This will:
+   - Compile TypeScript to JavaScript
+   - Bundle the library for both ESM and CommonJS formats
+   - Generate TypeScript declaration files
+   - Output files to the `dist/` directory
+
+4. **Verify the build:**
+   ```bash
+   ls -la dist/
+   ```
+
+   You should see:
+   - `svelte-feature-flags-toggly.es.js` - ES Module build
+   - `svelte-feature-flags-toggly.cjs` - CommonJS build
+   - `index.js` - Svelte component entry point
+   - `types/` - TypeScript declaration files
+
+### Testing the Build Locally
+
+You can test the built package locally using npm link:
+
+1. **Link the package:**
+   ```bash
+   npm link
+   ```
+
+2. **In your test project:**
+   ```bash
+   npm link @ops-ai/svelte-feature-flags-toggly
+   ```
+
+3. **Or test with the example app:**
+   ```bash
+   cd example
+   npm install
+   npm run dev
+   ```
+
+## Publishing to npm
+
+### Prerequisites for Publishing
+
+1. **npm account**: You need an npm account with access to the `@ops-ai` organization
+2. **Authentication**: You must be logged in to npm:
+   ```bash
+   npm login
+   ```
+
+3. **Organization access**: Ensure you have publish permissions for `@ops-ai` scope
+
+### Publishing Steps
+
+1. **Update version number:**
+   
+   Update the version in `package.json` following [Semantic Versioning](https://semver.org/):
+   - **Patch** (1.0.0 → 1.0.1): Bug fixes
+   - **Minor** (1.0.0 → 1.1.0): New features (backward compatible)
+   - **Major** (1.0.0 → 2.0.0): Breaking changes
+
+   ```bash
+   # Or use npm version command
+   npm version patch  # for 1.0.0 → 1.0.1
+   npm version minor  # for 1.0.0 → 1.1.0
+   npm version major  # for 1.0.0 → 2.0.0
+   ```
+
+2. **Update CHANGELOG.md:**
+   
+   Document the changes in `CHANGELOG.md` with the new version number and date.
+
+3. **Build the library:**
+   ```bash
+   npm run build
+   ```
+
+4. **Verify the build output:**
+   ```bash
+   # Check that dist/ contains all necessary files
+   ls -la dist/
+   ```
+
+5. **Dry run (optional but recommended):**
+   ```bash
+   npm publish --dry-run
+   ```
+   
+   This shows what would be published without actually publishing.
+
+6. **Publish to npm:**
+   ```bash
+   npm publish --access public
+   ```
+   
+   The `--access public` flag is required for scoped packages (`@ops-ai/...`) to be published publicly.
+
+### Publishing Checklist
+
+Before publishing, ensure:
+
+- [ ] Version number is updated in `package.json`
+- [ ] `CHANGELOG.md` is updated with new version
+- [ ] All tests pass (if applicable)
+- [ ] Build completes successfully
+- [ ] `dist/` directory contains all expected files
+- [ ] TypeScript declarations are generated correctly
+- [ ] README.md is up to date
+- [ ] License file is present
+- [ ] `.npmignore` excludes source files and examples
+
+### Post-Publishing
+
+After successful publication:
+
+1. **Create a git tag:**
+   ```bash
+   git tag v1.0.0
+   git push origin v1.0.0
+   ```
+
+2. **Verify on npm:**
+   Visit `https://www.npmjs.com/package/@ops-ai/svelte-feature-flags-toggly` to confirm the new version is available.
+
+3. **Update documentation:**
+   If this is a major release or includes breaking changes, update the main Toggly documentation.
+
+### Troubleshooting
+
+**Error: "You do not have permission to publish"**
+- Ensure you're logged in: `npm whoami`
+- Verify you have access to the `@ops-ai` organization
+- Contact the organization admin for access
+
+**Error: "Package name already exists"**
+- Check if the version already exists on npm
+- Increment the version number
+
+**Build fails:**
+- Ensure all dependencies are installed: `npm install`
+- Check TypeScript errors: `npm run typecheck`
+- Verify `vite.config.ts` is correctly configured
+
+## Find out more about Toggly.io
+
+Visit [our official website](https://toggly.io) or [check out a video overview of our product](https://docs.toggly.io/).

package/dist/svelte-feature-flags-toggly.cjs

@@ -0,0 +1 @@
+"use strict";var B=Object.defineProperty;var V=(e,t,n)=>t in e?B(e,t,{enumerable:!0,configurable:!0,writable:!0,value:n}):e[t]=n;var x=(e,t,n)=>V(e,typeof t!="symbol"?t+"":t,n);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const S=require("svelte/store"),H=require("svelte");class U{constructor(t){this._config={baseURI:"https://client.toggly.io",showFeatureDuringEvaluation:!1,featureFlagsRefreshInterval:3*60*1e3},this._features=null,this._loadingFeatures=!1,this._lastFetchTime=0,this.shouldShowFeatureDuringEvaluation=!1,this._loadFeatures=async()=>{this._loadingFeatures&&await new Promise(o=>{const l=()=>{this._loadingFeatures?setTimeout(l,100):o()};l()});const r=Date.now()-this._lastFetchTime,a=this._config.featureFlagsRefreshInterval??3*60*1e3;if(this._features!==null&&r<a)return this._features;if(this._features!==null&&r<a)return this._features;this._loadingFeatures=!0;try{var s=`${this._config.baseURI}/${this._config.appKey}-${this._config.environment}/defs`;this._config.identity&&(s+=`?u=${this._config.identity}`);const o=await fetch(s);this._features=await o.json(),this._lastFetchTime=Date.now()}catch{this._features===null&&(this._features=this._config.featureDefaults??{}),console.warn("Toggly --- Using feature defaults or cached values as features could not be loaded from the Toggly API")}finally{this._loadingFeatures=!1}return this._features},this._featuresLoaded=async()=>this._features??await this._loadFeatures(),this._evaluateFeatureGate=async(n,r="all",a=!1)=>{if(await this._featuresLoaded(),!this._features||Object.keys(this._features).length===0)return!0;var s;return r==="any"?s=n.reduce((o,l)=>o||this._features[l]&&this._features[l]===!0,!1):s=n.reduce((o,l)=>o&&this._features[l]&&this._features[l]===!0,!0),s=a?!s:s,s},this.evaluateFeatureGate=async(n,r="all",a=!1)=>await this._evaluateFeatureGate(n,r,a),this.isFeatureOn=async n=>await this._evaluateFeatureGate([n]),this.isFeatureOff=async n=>await this._evaluateFeatureGate([n],"all",!0),this.refreshFlags=async()=>{this._lastFetchTime=0,await this._loadFeatures()},t.appKey?t.environment||(t.environment="Production",console.warn("Toggly --- Using Production environment as no environment provided when initializing the Toggly")):t.featureDefaults?(this._features=t.featureDefaults??{},console.warn("Toggly --- Using feature defaults as no application key provided when initializing the Toggly")):console.warn("Toggly --- A valid application key is required to connect to your Toggly.io application for evaluating your features."),this._config=Object.assign({},this._config,t),this.shouldShowFeatureDuringEvaluation=this._config.showFeatureDuringEvaluation??!1}}const G=S.writable(null),m=S.writable({});function p(){const e=S.get(G);if(!e)throw new Error("Toggly service not initialized. Call createToggly() first.");return e}function J(e){return S.derived(m,t=>t[e]??!1)}async function Q(e){return await p().isFeatureOn(e)}async function W(e){return await p().isFeatureOff(e)}async function X(e,t="all",n=!1){return await p().evaluateFeatureGate(e,t,n)}function E(){}function Y(e,t){for(const n in t)e[n]=t[n];return e}function A(e){return e()}function q(){return Object.create(null)}function T(e){e.forEach(A)}function C(e){return typeof e=="function"}function Z(e,t){return e!=e?t==t:e!==t||e&&typeof e=="object"||typeof e=="function"}function $(e){return Object.keys(e).length===0}function ee(e,t,n,r){if(e){const a=z(e,t,n,r);return e[0](a)}}function z(e,t,n,r){return e[1]&&r?Y(n.ctx.slice(),e[1](r(t))):n.ctx}function te(e,t,n,r){return e[2],t.dirty}function re(e,t,n,r,a,s){if(a){const o=z(t,n,r,s);e.p(o,a)}}function ne(e){if(e.ctx.length>32){const t=[],n=e.ctx.length/32;for(let r=0;r<n;r++)t[r]=-1;return t}return-1}function ae(e,t,n){e.insertBefore(t,n||null)}function L(e){e.parentNode&&e.parentNode.removeChild(e)}function se(e){return document.createTextNode(e)}function ie(){return se("")}function oe(e){return Array.from(e.childNodes)}let K;function v(e){K=e}const y=[],P=[];let w=[];const N=[],ue=Promise.resolve();let k=!1;function le(){k||(k=!0,ue.then(M))}function I(e){w.push(e)}const O=new Set;let _=0;function M(){if(_!==0)return;const e=K;do{try{for(;_<y.length;){const t=y[_];_++,v(t),fe(t.$$)}}catch(t){throw y.length=0,_=0,t}for(v(null),y.length=0,_=0;P.length;)P.pop()();for(let t=0;t<w.length;t+=1){const n=w[t];O.has(n)||(O.add(n),n())}w.length=0}while(y.length);for(;N.length;)N.pop()();k=!1,O.clear(),v(e)}function fe(e){if(e.fragment!==null){e.update(),T(e.before_update);const t=e.dirty;e.dirty=[-1],e.fragment&&e.fragment.p(e.ctx,t),e.after_update.forEach(I)}}function ce(e){const t=[],n=[];w.forEach(r=>e.indexOf(r)===-1?t.push(r):n.push(r)),n.forEach(r=>r()),w=t}const b=new Set;let g;function he(){g={r:0,c:[],p:g}}function ge(){g.r||T(g.c),g=g.p}function F(e,t){e&&e.i&&(b.delete(e),e.i(t))}function D(e,t,n,r){if(e&&e.o){if(b.has(e))return;b.add(e),g.c.push(()=>{b.delete(e),r&&(n&&e.d(1),r())}),e.o(t)}else r&&r()}function de(e,t,n){const{fragment:r,after_update:a}=e.$$;r&&r.m(t,n),I(()=>{const s=e.$$.on_mount.map(A).filter(C);e.$$.on_destroy?e.$$.on_destroy.push(...s):T(s),e.$$.on_mount=[]}),a.forEach(I)}function _e(e,t){const n=e.$$;n.fragment!==null&&(ce(n.after_update),T(n.on_destroy),n.fragment&&n.fragment.d(t),n.on_destroy=n.fragment=null,n.ctx=[])}function ye(e,t){e.$$.dirty[0]===-1&&(y.push(e),le(),e.$$.dirty.fill(0)),e.$$.dirty[t/31|0]|=1<<t%31}function we(e,t,n,r,a,s,o=null,l=[-1]){const h=K;v(e);const i=e.$$={fragment:null,ctx:[],props:s,update:E,not_equal:a,bound:q(),on_mount:[],on_destroy:[],on_disconnect:[],before_update:[],after_update:[],context:new Map(t.context||(h?h.$$.context:[])),callbacks:q(),dirty:l,skip_bound:!1,root:t.target||h.$$.root};o&&o(i.root);let c=!1;if(i.ctx=n?n(e,t.props||{},(f,u,...d)=>{const j=d.length?d[0]:u;return i.ctx&&a(i.ctx[f],i.ctx[f]=j)&&(!i.skip_bound&&i.bound[f]&&i.bound[f](j),c&&ye(e,f)),u}):[],i.update(),c=!0,T(i.before_update),i.fragment=r?r(i.ctx):!1,t.target){if(t.hydrate){const f=oe(t.target);i.fragment&&i.fragment.l(f),f.forEach(L)}else i.fragment&&i.fragment.c();t.intro&&F(e.$$.fragment),de(e,t.target,t.anchor),M()}v(h)}class me{constructor(){x(this,"$$");x(this,"$$set")}$destroy(){_e(this,1),this.$destroy=E}$on(t,n){if(!C(n))return E;const r=this.$$.callbacks[t]||(this.$$.callbacks[t]=[]);return r.push(n),()=>{const a=r.indexOf(n);a!==-1&&r.splice(a,1)}}$set(t){this.$$set&&!$(t)&&(this.$$.skip_bound=!0,this.$$set(t),this.$$.skip_bound=!1)}}const ve="4";typeof window<"u"&&(window.__svelte||(window.__svelte={v:new Set})).v.add(ve);function R(e){let t;const n=e[7].default,r=ee(n,e,e[6],null);return{c(){r&&r.c()},m(a,s){r&&r.m(a,s),t=!0},p(a,s){r&&r.p&&(!t||s&64)&&re(r,n,a,a[6],t?te(n,a[6],s,null):ne(a[6]),null)},i(a){t||(F(r,a),t=!0)},o(a){D(r,a),t=!1},d(a){r&&r.d(a)}}}function Fe(e){let t,n,r=e[0]&&R(e);return{c(){r&&r.c(),t=ie()},m(a,s){r&&r.m(a,s),ae(a,t,s),n=!0},p(a,[s]){a[0]?r?(r.p(a,s),s&1&&F(r,1)):(r=R(a),r.c(),F(r,1),r.m(t.parentNode,t)):r&&(he(),D(r,1,1,()=>{r=null}),ge())},i(a){n||(F(r),n=!0)},o(a){D(r),n=!1},d(a){a&&L(t),r&&r.d(a)}}}function pe(e,t,n){let{$$slots:r={},$$scope:a}=t,{featureKey:s=void 0}=t,{featureKeys:o=void 0}=t,{requirement:l="all"}=t,{negate:h=!1}=t,i=!1,c=null;async function f(){if(!c)try{n(5,c=p())}catch(d){console.error("Toggly Feature component error:",d),n(0,i=!1);return}n(0,i=c.shouldShowFeatureDuringEvaluation);const u=[];if(s&&u.push(s),o&&u.push(...o),u.length>0&&c)try{n(0,i=await c.evaluateFeatureGate(u,l,h))}catch(d){console.error("Toggly Feature evaluation error:",d),n(0,i=!1)}else n(0,i=!0)}return H.onMount(()=>{f()}),e.$$set=u=>{"featureKey"in u&&n(1,s=u.featureKey),"featureKeys"in u&&n(2,o=u.featureKeys),"requirement"in u&&n(3,l=u.requirement),"negate"in u&&n(4,h=u.negate),"$$scope"in u&&n(6,a=u.$$scope)},e.$$.update=()=>{e.$$.dirty&38&&(c||s||o)&&f()},[i,s,o,l,h,c,a,r]}class Te extends me{constructor(t){super(),we(this,t,pe,Fe,Z,{featureKey:1,featureKeys:2,requirement:3,negate:4})}}async function be(e){const t=new U(e);G.set(t);try{const r=await t._loadFeatures();r&&m.set(r)}catch(r){console.error("Toggly initialization error:",r),m.set({})}const n=e.featureFlagsRefreshInterval??3*60*1e3;n>0&&e.appKey&&setInterval(async()=>{try{await t.refreshFlags();const r=await t._loadFeatures();r&&m.set(r)}catch(r){console.warn("Toggly refresh error:",r)}},n)}exports.Feature=Te;exports.Toggly=U;exports.createFeatureStore=J;exports.createToggly=be;exports.evaluateFeatureGate=X;exports.getTogglyService=p;exports.isFeatureOff=W;exports.isFeatureOn=Q;exports.togglyFlagsStore=m;exports.togglyServiceStore=G;

package/dist/svelte-feature-flags-toggly.es

@@ -0,0 +1,480 @@
+var B = Object.defineProperty;
+var M = (e, t, r) => t in e ? B(e, t, { enumerable: !0, configurable: !0, writable: !0, value: r }) : e[t] = r;
+var x = (e, t, r) => M(e, typeof t != "symbol" ? t + "" : t, r);
+import { writable as R, get as V, derived as H } from "svelte/store";
+import { onMount as J } from "svelte";
+class Q {
+  constructor(t) {
+    this._config = {
+      baseURI: "https://client.toggly.io",
+      showFeatureDuringEvaluation: !1,
+      featureFlagsRefreshInterval: 3 * 60 * 1e3
+      // 3 minutes
+    }, this._features = null, this._loadingFeatures = !1, this._lastFetchTime = 0, this.shouldShowFeatureDuringEvaluation = !1, this._loadFeatures = async () => {
+      this._loadingFeatures && await new Promise((o) => {
+        const l = () => {
+          this._loadingFeatures ? setTimeout(l, 100) : o();
+        };
+        l();
+      });
+      const n = Date.now() - this._lastFetchTime, a = this._config.featureFlagsRefreshInterval ?? 3 * 60 * 1e3;
+      if (this._features !== null && n < a)
+        return this._features;
+      if (this._features !== null && n < a)
+        return this._features;
+      this._loadingFeatures = !0;
+      try {
+        var s = `${this._config.baseURI}/${this._config.appKey}-${this._config.environment}/defs`;
+        this._config.identity && (s += `?u=${this._config.identity}`);
+        const o = await fetch(s);
+        this._features = await o.json(), this._lastFetchTime = Date.now();
+      } catch {
+        this._features === null && (this._features = this._config.featureDefaults ?? {}), console.warn(
+          "Toggly --- Using feature defaults or cached values as features could not be loaded from the Toggly API"
+        );
+      } finally {
+        this._loadingFeatures = !1;
+      }
+      return this._features;
+    }, this._featuresLoaded = async () => this._features ?? await this._loadFeatures(), this._evaluateFeatureGate = async (r, n = "all", a = !1) => {
+      if (await this._featuresLoaded(), !this._features || Object.keys(this._features).length === 0)
+        return !0;
+      var s;
+      return n === "any" ? s = r.reduce((o, l) => o || this._features[l] && this._features[l] === !0, !1) : s = r.reduce((o, l) => o && this._features[l] && this._features[l] === !0, !0), s = a ? !s : s, s;
+    }, this.evaluateFeatureGate = async (r, n = "all", a = !1) => await this._evaluateFeatureGate(r, n, a), this.isFeatureOn = async (r) => await this._evaluateFeatureGate([r]), this.isFeatureOff = async (r) => await this._evaluateFeatureGate([r], "all", !0), this.refreshFlags = async () => {
+      this._lastFetchTime = 0, await this._loadFeatures();
+    }, t.appKey ? t.environment || (t.environment = "Production", console.warn(
+      "Toggly --- Using Production environment as no environment provided when initializing the Toggly"
+    )) : t.featureDefaults ? (this._features = t.featureDefaults ?? {}, console.warn(
+      "Toggly --- Using feature defaults as no application key provided when initializing the Toggly"
+    )) : console.warn(
+      "Toggly --- A valid application key is required to connect to your Toggly.io application for evaluating your features."
+    ), this._config = Object.assign({}, this._config, t), this.shouldShowFeatureDuringEvaluation = this._config.showFeatureDuringEvaluation ?? !1;
+  }
+}
+const U = R(null), p = R({});
+function b() {
+  const e = V(U);
+  if (!e)
+    throw new Error("Toggly service not initialized. Call createToggly() first.");
+  return e;
+}
+function be(e) {
+  return H(p, (t) => t[e] ?? !1);
+}
+async function xe(e) {
+  return await b().isFeatureOn(e);
+}
+async function Ee(e) {
+  return await b().isFeatureOff(e);
+}
+async function Se(e, t = "all", r = !1) {
+  return await b().evaluateFeatureGate(e, t, r);
+}
+function S() {
+}
+function W(e, t) {
+  for (const r in t) e[r] = t[r];
+  return (
+    /** @type {T & S} */
+    e
+  );
+}
+function q(e) {
+  return e();
+}
+function G() {
+  return /* @__PURE__ */ Object.create(null);
+}
+function F(e) {
+  e.forEach(q);
+}
+function A(e) {
+  return typeof e == "function";
+}
+function X(e, t) {
+  return e != e ? t == t : e !== t || e && typeof e == "object" || typeof e == "function";
+}
+function Y(e) {
+  return Object.keys(e).length === 0;
+}
+function Z(e, t, r, n) {
+  if (e) {
+    const a = C(e, t, r, n);
+    return e[0](a);
+  }
+}
+function C(e, t, r, n) {
+  return e[1] && n ? W(r.ctx.slice(), e[1](n(t))) : r.ctx;
+}
+function $(e, t, r, n) {
+  return e[2], t.dirty;
+}
+function ee(e, t, r, n, a, s) {
+  if (a) {
+    const o = C(t, r, n, s);
+    e.p(o, a);
+  }
+}
+function te(e) {
+  if (e.ctx.length > 32) {
+    const t = [], r = e.ctx.length / 32;
+    for (let n = 0; n < r; n++)
+      t[n] = -1;
+    return t;
+  }
+  return -1;
+}
+function ne(e, t, r) {
+  e.insertBefore(t, r || null);
+}
+function z(e) {
+  e.parentNode && e.parentNode.removeChild(e);
+}
+function re(e) {
+  return document.createTextNode(e);
+}
+function ae() {
+  return re("");
+}
+function se(e) {
+  return Array.from(e.childNodes);
+}
+let D;
+function w(e) {
+  D = e;
+}
+const y = [], j = [];
+let m = [];
+const N = [], ie = /* @__PURE__ */ Promise.resolve();
+let k = !1;
+function oe() {
+  k || (k = !0, ie.then(L));
+}
+function O(e) {
+  m.push(e);
+}
+const E = /* @__PURE__ */ new Set();
+let g = 0;
+function L() {
+  if (g !== 0)
+    return;
+  const e = D;
+  do {
+    try {
+      for (; g < y.length; ) {
+        const t = y[g];
+        g++, w(t), ue(t.$$);
+      }
+    } catch (t) {
+      throw y.length = 0, g = 0, t;
+    }
+    for (w(null), y.length = 0, g = 0; j.length; ) j.pop()();
+    for (let t = 0; t < m.length; t += 1) {
+      const r = m[t];
+      E.has(r) || (E.add(r), r());
+    }
+    m.length = 0;
+  } while (y.length);
+  for (; N.length; )
+    N.pop()();
+  k = !1, E.clear(), w(e);
+}
+function ue(e) {
+  if (e.fragment !== null) {
+    e.update(), F(e.before_update);
+    const t = e.dirty;
+    e.dirty = [-1], e.fragment && e.fragment.p(e.ctx, t), e.after_update.forEach(O);
+  }
+}
+function le(e) {
+  const t = [], r = [];
+  m.forEach((n) => e.indexOf(n) === -1 ? t.push(n) : r.push(n)), r.forEach((n) => n()), m = t;
+}
+const T = /* @__PURE__ */ new Set();
+let d;
+function fe() {
+  d = {
+    r: 0,
+    c: [],
+    p: d
+    // parent group
+  };
+}
+function ce() {
+  d.r || F(d.c), d = d.p;
+}
+function v(e, t) {
+  e && e.i && (T.delete(e), e.i(t));
+}
+function I(e, t, r, n) {
+  if (e && e.o) {
+    if (T.has(e)) return;
+    T.add(e), d.c.push(() => {
+      T.delete(e), n && (r && e.d(1), n());
+    }), e.o(t);
+  } else n && n();
+}
+function he(e, t, r) {
+  const { fragment: n, after_update: a } = e.$$;
+  n && n.m(t, r), O(() => {
+    const s = e.$$.on_mount.map(q).filter(A);
+    e.$$.on_destroy ? e.$$.on_destroy.push(...s) : F(s), e.$$.on_mount = [];
+  }), a.forEach(O);
+}
+function de(e, t) {
+  const r = e.$$;
+  r.fragment !== null && (le(r.after_update), F(r.on_destroy), r.fragment && r.fragment.d(t), r.on_destroy = r.fragment = null, r.ctx = []);
+}
+function _e(e, t) {
+  e.$$.dirty[0] === -1 && (y.push(e), oe(), e.$$.dirty.fill(0)), e.$$.dirty[t / 31 | 0] |= 1 << t % 31;
+}
+function ge(e, t, r, n, a, s, o = null, l = [-1]) {
+  const h = D;
+  w(e);
+  const i = e.$$ = {
+    fragment: null,
+    ctx: [],
+    // state
+    props: s,
+    update: S,
+    not_equal: a,
+    bound: G(),
+    // lifecycle
+    on_mount: [],
+    on_destroy: [],
+    on_disconnect: [],
+    before_update: [],
+    after_update: [],
+    context: new Map(t.context || (h ? h.$$.context : [])),
+    // everything else
+    callbacks: G(),
+    dirty: l,
+    skip_bound: !1,
+    root: t.target || h.$$.root
+  };
+  o && o(i.root);
+  let c = !1;
+  if (i.ctx = r ? r(e, t.props || {}, (f, u, ..._) => {
+    const K = _.length ? _[0] : u;
+    return i.ctx && a(i.ctx[f], i.ctx[f] = K) && (!i.skip_bound && i.bound[f] && i.bound[f](K), c && _e(e, f)), u;
+  }) : [], i.update(), c = !0, F(i.before_update), i.fragment = n ? n(i.ctx) : !1, t.target) {
+    if (t.hydrate) {
+      const f = se(t.target);
+      i.fragment && i.fragment.l(f), f.forEach(z);
+    } else
+      i.fragment && i.fragment.c();
+    t.intro && v(e.$$.fragment), he(e, t.target, t.anchor), L();
+  }
+  w(h);
+}
+class ye {
+  constructor() {
+    /**
+     * ### PRIVATE API
+     *
+     * Do not use, may change at any time
+     *
+     * @type {any}
+     */
+    x(this, "$$");
+    /**
+     * ### PRIVATE API
+     *
+     * Do not use, may change at any time
+     *
+     * @type {any}
+     */
+    x(this, "$$set");
+  }
+  /** @returns {void} */
+  $destroy() {
+    de(this, 1), this.$destroy = S;
+  }
+  /**
+   * @template {Extract<keyof Events, string>} K
+   * @param {K} type
+   * @param {((e: Events[K]) => void) | null | undefined} callback
+   * @returns {() => void}
+   */
+  $on(t, r) {
+    if (!A(r))
+      return S;
+    const n = this.$$.callbacks[t] || (this.$$.callbacks[t] = []);
+    return n.push(r), () => {
+      const a = n.indexOf(r);
+      a !== -1 && n.splice(a, 1);
+    };
+  }
+  /**
+   * @param {Partial<Props>} props
+   * @returns {void}
+   */
+  $set(t) {
+    this.$$set && !Y(t) && (this.$$.skip_bound = !0, this.$$set(t), this.$$.skip_bound = !1);
+  }
+}
+const me = "4";
+typeof window < "u" && (window.__svelte || (window.__svelte = { v: /* @__PURE__ */ new Set() })).v.add(me);
+function P(e) {
+  let t;
+  const r = (
+    /*#slots*/
+    e[7].default
+  ), n = Z(
+    r,
+    e,
+    /*$$scope*/
+    e[6],
+    null
+  );
+  return {
+    c() {
+      n && n.c();
+    },
+    m(a, s) {
+      n && n.m(a, s), t = !0;
+    },
+    p(a, s) {
+      n && n.p && (!t || s & /*$$scope*/
+      64) && ee(
+        n,
+        r,
+        a,
+        /*$$scope*/
+        a[6],
+        t ? $(
+          r,
+          /*$$scope*/
+          a[6],
+          s,
+          null
+        ) : te(
+          /*$$scope*/
+          a[6]
+        ),
+        null
+      );
+    },
+    i(a) {
+      t || (v(n, a), t = !0);
+    },
+    o(a) {
+      I(n, a), t = !1;
+    },
+    d(a) {
+      n && n.d(a);
+    }
+  };
+}
+function we(e) {
+  let t, r, n = (
+    /*shouldShow*/
+    e[0] && P(e)
+  );
+  return {
+    c() {
+      n && n.c(), t = ae();
+    },
+    m(a, s) {
+      n && n.m(a, s), ne(a, t, s), r = !0;
+    },
+    p(a, [s]) {
+      /*shouldShow*/
+      a[0] ? n ? (n.p(a, s), s & /*shouldShow*/
+      1 && v(n, 1)) : (n = P(a), n.c(), v(n, 1), n.m(t.parentNode, t)) : n && (fe(), I(n, 1, 1, () => {
+        n = null;
+      }), ce());
+    },
+    i(a) {
+      r || (v(n), r = !0);
+    },
+    o(a) {
+      I(n), r = !1;
+    },
+    d(a) {
+      a && z(t), n && n.d(a);
+    }
+  };
+}
+function ve(e, t, r) {
+  let { $$slots: n = {}, $$scope: a } = t, { featureKey: s = void 0 } = t, { featureKeys: o = void 0 } = t, { requirement: l = "all" } = t, { negate: h = !1 } = t, i = !1, c = null;
+  async function f() {
+    if (!c)
+      try {
+        r(5, c = b());
+      } catch (_) {
+        console.error("Toggly Feature component error:", _), r(0, i = !1);
+        return;
+      }
+    r(0, i = c.shouldShowFeatureDuringEvaluation);
+    const u = [];
+    if (s && u.push(s), o && u.push(...o), u.length > 0 && c)
+      try {
+        r(0, i = await c.evaluateFeatureGate(u, l, h));
+      } catch (_) {
+        console.error("Toggly Feature evaluation error:", _), r(0, i = !1);
+      }
+    else
+      r(0, i = !0);
+  }
+  return J(() => {
+    f();
+  }), e.$$set = (u) => {
+    "featureKey" in u && r(1, s = u.featureKey), "featureKeys" in u && r(2, o = u.featureKeys), "requirement" in u && r(3, l = u.requirement), "negate" in u && r(4, h = u.negate), "$$scope" in u && r(6, a = u.$$scope);
+  }, e.$$.update = () => {
+    e.$$.dirty & /*toggly, featureKey, featureKeys*/
+    38 && (c || s || o) && f();
+  }, [
+    i,
+    s,
+    o,
+    l,
+    h,
+    c,
+    a,
+    n
+  ];
+}
+class ke extends ye {
+  constructor(t) {
+    super(), ge(this, t, ve, we, X, {
+      featureKey: 1,
+      featureKeys: 2,
+      requirement: 3,
+      negate: 4
+    });
+  }
+}
+async function Oe(e) {
+  const t = new Q(e);
+  U.set(t);
+  try {
+    const n = await t._loadFeatures();
+    n && p.set(n);
+  } catch (n) {
+    console.error("Toggly initialization error:", n), p.set({});
+  }
+  const r = e.featureFlagsRefreshInterval ?? 3 * 60 * 1e3;
+  r > 0 && e.appKey && setInterval(async () => {
+    try {
+      await t.refreshFlags();
+      const n = await t._loadFeatures();
+      n && p.set(n);
+    } catch (n) {
+      console.warn("Toggly refresh error:", n);
+    }
+  }, r);
+}
+export {
+  ke as Feature,
+  Q as Toggly,
+  be as createFeatureStore,
+  Oe as createToggly,
+  Se as evaluateFeatureGate,
+  b as getTogglyService,
+  Ee as isFeatureOff,
+  xe as isFeatureOn,
+  p as togglyFlagsStore,
+  U as togglyServiceStore
+};

package/dist/types/components/index.d.ts

@@ -0,0 +1,2 @@
+export { default as Feature } from './Feature.svelte';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+export * from './services';
+export * from './stores';
+export * from './components';
+export * from './utils';
+export { default as Feature } from './components/Feature.svelte';
+export { createToggly } from './utils/createToggly';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AAGvB,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/types/services/index.d.ts

@@ -0,0 +1,2 @@
+export * from './toggly.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA"}

package/dist/types/services/toggly.service.d.ts

@@ -0,0 +1,46 @@
+export interface TogglyOptions {
+    baseURI?: string;
+    appKey?: string;
+    environment?: string;
+    identity?: string;
+    featureDefaults?: {
+        [key: string]: boolean;
+    };
+    showFeatureDuringEvaluation?: boolean;
+    featureFlagsRefreshInterval?: number;
+}
+export interface TogglyService {
+    shouldShowFeatureDuringEvaluation: boolean;
+    _loadFeatures: () => Promise<{
+        [key: string]: boolean;
+    } | null>;
+    _featuresLoaded: () => Promise<{
+        [key: string]: boolean;
+    } | null>;
+    _evaluateFeatureGate: (gate: string[], requirement: string, negate: boolean) => Promise<boolean>;
+    evaluateFeatureGate: (featureKeys: string[], requirement: string, negate: boolean) => Promise<boolean>;
+    isFeatureOn: (featureKey: string) => Promise<boolean>;
+    isFeatureOff: (featureKey: string) => Promise<boolean>;
+    refreshFlags: () => Promise<void>;
+}
+export declare class Toggly implements TogglyService {
+    private _config;
+    private _features;
+    private _loadingFeatures;
+    private _lastFetchTime;
+    shouldShowFeatureDuringEvaluation: boolean;
+    constructor(config: TogglyOptions);
+    _loadFeatures: () => Promise<{
+        [key: string]: boolean;
+    } | null>;
+    _featuresLoaded: () => Promise<{
+        [key: string]: boolean;
+    } | null>;
+    _evaluateFeatureGate: (gate: string[], requirement?: string, negate?: boolean) => Promise<boolean>;
+    evaluateFeatureGate: (featureKeys: string[], requirement?: string, negate?: boolean) => Promise<boolean>;
+    isFeatureOn: (featureKey: string) => Promise<boolean>;
+    isFeatureOff: (featureKey: string) => Promise<boolean>;
+    refreshFlags: () => Promise<void>;
+}
+export default Toggly;
+//# sourceMappingURL=toggly.service.d.ts.map

package/dist/types/services/toggly.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggly.service.d.ts","sourceRoot":"","sources":["../../../src/services/toggly.service.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,eAAe,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;IAC5C,2BAA2B,CAAC,EAAE,OAAO,CAAA;IACrC,2BAA2B,CAAC,EAAE,MAAM,CAAA;CACrC;AAED,MAAM,WAAW,aAAa;IAC5B,iCAAiC,EAAE,OAAO,CAAA;IAC1C,aAAa,EAAE,MAAM,OAAO,CAAC;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAC/D,eAAe,EAAE,MAAM,OAAO,CAAC;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IACjE,oBAAoB,EAAE,CACpB,IAAI,EAAE,MAAM,EAAE,EACd,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,KACZ,OAAO,CAAC,OAAO,CAAC,CAAA;IACrB,mBAAmB,EAAE,CACnB,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,KACZ,OAAO,CAAC,OAAO,CAAC,CAAA;IACrB,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACrD,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACtD,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAClC;AAED,qBAAa,MAAO,YAAW,aAAa;IAC1C,OAAO,CAAC,OAAO,CAId;IACD,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,gBAAgB,CAAiB;IACzC,OAAO,CAAC,cAAc,CAAY;IAElC,iCAAiC,EAAE,OAAO,CAAQ;gBAEtC,MAAM,EAAE,aAAa;IA2BjC,aAAa;;cAsDZ;IAED,eAAe;;cAEd;IAED,oBAAoB,GAClB,MAAM,MAAM,EAAE,EACd,oBAAmB,EACnB,gBAAc,sBA8Bf;IAED,mBAAmB,GACjB,aAAa,MAAM,EAAE,EACrB,oBAAmB,EACnB,gBAAc,sBAGf;IAED,WAAW,GAAU,YAAY,MAAM,sBAEtC;IAED,YAAY,GAAU,YAAY,MAAM,sBAEvC;IAED,YAAY,QAAa,OAAO,CAAC,IAAI,CAAC,CAGrC;CACF;AAED,eAAe,MAAM,CAAA"}

package/dist/types/stores/index.d.ts

@@ -0,0 +1,2 @@
+export * from './toggly.store';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/stores/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stores/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA"}

package/dist/types/stores/toggly.store.d.ts

@@ -0,0 +1,43 @@
+import type { TogglyService } from '../services/toggly.service';
+/**
+ * Store for the Toggly service instance
+ */
+export declare const togglyServiceStore: import("svelte/store").Writable<TogglyService | null>;
+/**
+ * Store for feature flags (key-value pairs)
+ */
+export declare const togglyFlagsStore: import("svelte/store").Writable<{
+    [key: string]: boolean;
+}>;
+/**
+ * Get the Toggly service instance from the store
+ * @throws Error if service is not initialized
+ */
+export declare function getTogglyService(): TogglyService;
+/**
+ * Create a derived store for a specific feature flag
+ * @param featureKey - The feature flag key
+ * @returns A derived store that returns the boolean value of the feature flag
+ */
+export declare function createFeatureStore(featureKey: string): import("svelte/store").Readable<boolean>;
+/**
+ * Check if a feature is enabled
+ * @param featureKey - The feature flag key
+ * @returns Promise resolving to true if feature is enabled
+ */
+export declare function isFeatureOn(featureKey: string): Promise<boolean>;
+/**
+ * Check if a feature is disabled
+ * @param featureKey - The feature flag key
+ * @returns Promise resolving to true if feature is disabled
+ */
+export declare function isFeatureOff(featureKey: string): Promise<boolean>;
+/**
+ * Evaluate a feature gate (multiple features with requirement and negate)
+ * @param featureKeys - Array of feature flag keys
+ * @param requirement - 'all' or 'any' (default: 'all')
+ * @param negate - Whether to negate the result (default: false)
+ * @returns Promise resolving to the evaluation result
+ */
+export declare function evaluateFeatureGate(featureKeys: string[], requirement?: 'all' | 'any', negate?: boolean): Promise<boolean>;
+//# sourceMappingURL=toggly.store.d.ts.map

package/dist/types/stores/toggly.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggly.store.d.ts","sourceRoot":"","sources":["../../../src/stores/toggly.store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE/D;;GAEG;AACH,eAAO,MAAM,kBAAkB,uDAAuC,CAAA;AAEtE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;EAA2C,CAAA;AAExE;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAMhD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,4CAEpD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtE;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGvE;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,GAAE,KAAK,GAAG,KAAa,EAClC,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,OAAO,CAAC,CAGlB"}

package/dist/types/utils/createToggly.d.ts

@@ -0,0 +1,22 @@
+import { type TogglyOptions } from '../services/toggly.service';
+/**
+ * Initialize Toggly with the provided configuration
+ * This function sets up the Toggly service and loads feature flags
+ *
+ * @param config - Toggly configuration options
+ * @returns Promise that resolves when initialization is complete
+ *
+ * @example
+ * ```typescript
+ * import { createToggly } from '@ops-ai/svelte-feature-flags-toggly'
+ *
+ * await createToggly({
+ *   appKey: 'your-app-key',
+ *   environment: 'Production',
+ *   identity: 'user-123'
+ * })
+ * ```
+ */
+export declare function createToggly(config: TogglyOptions): Promise<void>;
+export default createToggly;
+//# sourceMappingURL=createToggly.d.ts.map

package/dist/types/utils/createToggly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createToggly.d.ts","sourceRoot":"","sources":["../../../src/utils/createToggly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAGvE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCvE;AAED,eAAe,YAAY,CAAA"}

package/dist/types/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './createToggly';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@ops-ai/svelte-feature-flags-toggly",
+  "version": "1.0.0",
+  "description": "Provides feature flags support for Svelte applications allowing you to enable and disable features easily. Can be used with or without Toggly.io.",
+  "type": "module",
+  "main": "./dist/svelte-feature-flags-toggly.cjs",
+  "module": "./dist/svelte-feature-flags-toggly.es.js",
+  "svelte": "./dist/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/svelte-feature-flags-toggly.es.js",
+      "require": "./dist/svelte-feature-flags-toggly.cjs",
+      "svelte": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/types/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build && tsc --emitDeclarationOnly --outDir dist/types",
+    "prepublishOnly": "npm run build",
+    "check": "svelte-check --tsconfig ./tsconfig.json",
+    "check:watch": "svelte-check --tsconfig ./tsconfig.json --watch",
+    "test": "vitest",
+    "typecheck": "svelte-check --tsconfig ./tsconfig.json"
+  },
+  "keywords": [
+    "svelte",
+    "feature-flags",
+    "feature-toggles",
+    "toggly",
+    "ab-testing"
+  ],
+  "author": {
+    "name": "Cosmin Atomei",
+    "email": "cosmin.atomei@gmail.com"
+  },
+  "license": "BSD-3-Clause",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ops-ai/Toggly.FeatureManagement.git",
+    "directory": "Toggly.FeatureManagement/Toggly.FeatureManagement.Svelte/svelte-feature-flags-toggly"
+  },
+  "bugs": {
+    "url": "https://github.com/ops-ai/Toggly.FeatureManagement/issues"
+  },
+  "homepage": "https://github.com/ops-ai/Toggly.FeatureManagement/tree/develop/Toggly.FeatureManagement/Toggly.FeatureManagement.Svelte/svelte-feature-flags-toggly#readme",
+  "peerDependencies": {
+    "svelte": "^4.0.0 || ^5.0.0"
+  },
+  "devDependencies": {
+    "@sveltejs/vite-plugin-svelte": "^3.0.0",
+    "@types/node": "^20.0.0",
+    "svelte": "^4.2.0",
+    "svelte-check": "^3.6.0",
+    "typescript": "^5.0.0",
+    "vite": "^5.0.0",
+    "vitest": "^1.0.0"
+  }
+}