@proveanything/smartlinks 2.0.65 → 2.0.66

package/dist/api/appConfiguration.d.ts

@@ -483,4 +483,27 @@ export declare namespace appConfiguration {
      * ```
      */
     function isFeatureEnabledSync(collectionId: string, flag: string): boolean | undefined;
+    /**
+     * Has the collection SWITCHED ON this part of the platform (`appConfig.enabled[key]`)? A missing
+     * key is on — only an explicit `false` is off. This is "does this business use it", not "does the
+     * plan allow it": for something a plan gates, check `resolveFeature()` as well. docs/appConfig.md §8a.
+     */
+    function resolveEnabled(cfg: {
+        enabled?: Record<string, boolean>;
+    } | null | undefined, key: string): boolean;
+    /**
+     * Has the collection switched on `key` (`products`, `crm`, `analytics`, `hub`, `portal`,
+     * `printStudio`, or an app's own key)? Hide what's off: a website-only business switches off
+     * products and the CRM, so menus, cards and setup steps for them shouldn't appear.
+     *
+     * @example
+     * ```typescript
+     * if (await appConfiguration.isEnabled(collectionId, 'products')) showProductsMenu();
+     * ```
+     */
+    function isEnabled(collectionId: string, key: string, options?: {
+        force?: boolean;
+    }): Promise<boolean>;
+    /** Cache-only `isEnabled` — `undefined` until `getAppConfig()` has been read this page load. */
+    function isEnabledSync(collectionId: string, key: string): boolean | undefined;
 }

package/dist/api/appConfiguration.js

@@ -620,4 +620,36 @@ export var appConfiguration;
         return resolveFeature(cfg.system, flag);
     }
     appConfiguration.isFeatureEnabledSync = isFeatureEnabledSync;
+    /**
+     * Has the collection SWITCHED ON this part of the platform (`appConfig.enabled[key]`)? A missing
+     * key is on — only an explicit `false` is off. This is "does this business use it", not "does the
+     * plan allow it": for something a plan gates, check `resolveFeature()` as well. docs/appConfig.md §8a.
+     */
+    function resolveEnabled(cfg, key) {
+        var _a;
+        return ((_a = cfg === null || cfg === void 0 ? void 0 : cfg.enabled) === null || _a === void 0 ? void 0 : _a[key]) !== false;
+    }
+    appConfiguration.resolveEnabled = resolveEnabled;
+    /**
+     * Has the collection switched on `key` (`products`, `crm`, `analytics`, `hub`, `portal`,
+     * `printStudio`, or an app's own key)? Hide what's off: a website-only business switches off
+     * products and the CRM, so menus, cards and setup steps for them shouldn't appear.
+     *
+     * @example
+     * ```typescript
+     * if (await appConfiguration.isEnabled(collectionId, 'products')) showProductsMenu();
+     * ```
+     */
+    async function isEnabled(collectionId, key, options) {
+        return resolveEnabled(await getAppConfig(collectionId, options), key);
+    }
+    appConfiguration.isEnabled = isEnabled;
+    /** Cache-only `isEnabled` — `undefined` until `getAppConfig()` has been read this page load. */
+    function isEnabledSync(collectionId, key) {
+        const cfg = cache.peek(appConfigCacheKey(collectionId));
+        if (!cfg)
+            return undefined;
+        return resolveEnabled(cfg, key);
+    }
+    appConfiguration.isEnabledSync = isEnabledSync;
 })(appConfiguration || (appConfiguration = {}));

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.0.65  |  Generated: 2026-10-14T11:51:48.823Z
+Version: 2.0.66  |  Generated: 2026-10-14T17:03:31.949Z
 
 This is a concise summary of all available API functions and types.
 
@@ -2479,6 +2479,7 @@ interface AppConfigSettings {
   addOns?: string[]
   requestedBasePlanId?: string
   itemRecordMode?: 'registered' | 'owned' | null
+  enabled?: Record<string, boolean>
   system?: SystemBlock
 }
 ```
@@ -10886,6 +10887,15 @@ Check whether a feature flag is enabled for a collection, per `appConfig.system.
 **isFeatureEnabledSync**(collectionId: string, flag: string) → `boolean | undefined`
 Synchronous, cache-only check for a feature flag. Returns `undefined` if `getAppConfig()` / `isFeatureEnabled()` hasn't been called yet for this collection this page load (i.e. nothing to read without an await) — treat `undefined` as "not yet known", not as "disabled". ```typescript // Warm the cache once, e.g. in a top-level effect: useEffect(() => { appConfiguration.isFeatureEnabled(collectionId, 'custom_domain') }, [collectionId]); // Elsewhere, read synchronously without an await: const enabled = appConfiguration.isFeatureEnabledSync(collectionId, 'custom_domain'); if (enabled === undefined) { // not warmed yet — fall back to a loading state or the async version } ```
 
+**resolveEnabled**(cfg: { enabled?: Record<string, boolean> } | null | undefined, key: string) → `boolean`
+Has the collection SWITCHED ON this part of the platform (`appConfig.enabled[key]`)? A missing key is on — only an explicit `false` is off. This is "does this business use it", not "does the plan allow it": for something a plan gates, check `resolveFeature()` as well. docs/appConfig.md §8a.
+
+**isEnabled**(collectionId: string, key: string, options?: { force?: boolean }) → `Promise<boolean>`
+Has the collection switched on `key` (`products`, `crm`, `analytics`, `hub`, `portal`, `printStudio`, or an app's own key)? Hide what's off: a website-only business switches off products and the CRM, so menus, cards and setup steps for them shouldn't appear. ```typescript if (await appConfiguration.isEnabled(collectionId, 'products')) showProductsMenu(); ```
+
+**isEnabledSync**(collectionId: string, key: string) → `boolean | undefined`
+Cache-only `isEnabled` — `undefined` until `getAppConfig()` has been read this page load.
+
 ### asset
 
 **upload**(options: UploadAssetOptions) → `Promise<Asset>`

package/dist/docs/appConfig.md

@@ -36,6 +36,8 @@ export interface AppConfigSettings {
 
   /** How the account handles individual physical items. */
   itemRecordMode?: 'registered' | 'owned' | null;
+  /** What the collection has switched on (absent key = on) — see §8a. */
+  enabled?: Record<string, boolean>;
 
   // ── SYSTEM-OWNED, PUBLIC (reconcile writes; client read-only) ─────
   /** Resolved entitlement truth. Read this to gate features. */
@@ -501,6 +503,41 @@ the customer add-ons page (`src/components/pricing/ItemHandlingSection`)
 because these settings change the whole UX shape (claim, ownership,
 CRM visibility), not just a capability flag.
 
+## 8a. What's switched on (`enabled`)
+
+A root-level, user-owned map (like `itemRecordMode`; reconcile never touches it) saying which parts of
+the platform this collection **uses** — separate from what its plan **allows** (`system.features`):
+
+| | Plan allows (`system.features`) | Switched on (`enabled`) |
+|---|---|---|
+| Written by | billing (`entitlements-reconcile`) | the collection: sign-up wizards, admins |
+| Means | "you may have this" | "this business uses this" |
+| Missing key | standard: off · enterprise: on | **on** |
+
+```json
+{ "enabled": { "products": false, "crm": false, "hub": false, "portal": false, "printStudio": false } }
+```
+
+**A missing key is on**, so a collection that never set `enabled` behaves exactly as before. Only an
+explicit `false` switches something off. A website-only sign-up switches off what it doesn't use
+(products, CRM, Hub, Portal…), and Studio hides the menus, dashboard cards and setup steps for them;
+an admin can switch them back on.
+
+Known keys: `products`, `crm`, `analytics`, `hub`, `portal`, `printStudio`. The map is open — an app
+may define its own key.
+
+```ts
+if (await SL.appConfiguration.isEnabled(collectionId, 'products')) showProducts()
+// already have the config:
+SL.appConfiguration.resolveEnabled(cfg, 'crm')
+```
+
+For something a plan gates, show it only when both hold: `resolveEnabled(cfg, key)` **and**
+`resolveFeature(cfg.system, flag)`.
+
+Write it through the admin settings route (`collection.updateSettings(collectionId, 'appConfig',
+{ enabled: { products: true } })`) — keys merge, so set only the ones you change.
+
 ## 9. Migration notes
 
 - Legacy `entitlements` settings group is deprecated. Everything moved

package/dist/openapi.yaml

@@ -19168,6 +19168,10 @@ components:
           enum:
             - registered
             - owned
+        enabled:
+          type: object
+          additionalProperties:
+            type: boolean
         system:
           $ref: "#/components/schemas/SystemBlock"
       required:

package/dist/types/appConfiguration.d.ts

@@ -128,6 +128,14 @@ export interface AppConfigSettings {
     requestedBasePlanId?: string;
     /** How the account handles individual physical items. */
     itemRecordMode?: 'registered' | 'owned' | null;
+    /**
+     * What this collection has SWITCHED ON — separate from what its plan allows (`system.features`).
+     * A missing key means on, so collections that never set it behave as they always have. A website
+     * sign-up switches off what it doesn't use, e.g. `{ products: false, crm: false, hub: false }`.
+     * Known keys: `products`, `crm`, `analytics`, `hub`, `portal`, `printStudio`; the map is open.
+     * Read it with `appConfiguration.isEnabled()` / `resolveEnabled()` — docs/appConfig.md §8a.
+     */
+    enabled?: Record<string, boolean>;
     /** Resolved entitlement truth. Read this to gate features. */
     system?: SystemBlock;
 }

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.0.65  |  Generated: 2026-10-14T11:51:48.823Z
+Version: 2.0.66  |  Generated: 2026-10-14T17:03:31.949Z
 
 This is a concise summary of all available API functions and types.
 
@@ -2479,6 +2479,7 @@ interface AppConfigSettings {
   addOns?: string[]
   requestedBasePlanId?: string
   itemRecordMode?: 'registered' | 'owned' | null
+  enabled?: Record<string, boolean>
   system?: SystemBlock
 }
 ```
@@ -10886,6 +10887,15 @@ Check whether a feature flag is enabled for a collection, per `appConfig.system.
 **isFeatureEnabledSync**(collectionId: string, flag: string) → `boolean | undefined`
 Synchronous, cache-only check for a feature flag. Returns `undefined` if `getAppConfig()` / `isFeatureEnabled()` hasn't been called yet for this collection this page load (i.e. nothing to read without an await) — treat `undefined` as "not yet known", not as "disabled". ```typescript // Warm the cache once, e.g. in a top-level effect: useEffect(() => { appConfiguration.isFeatureEnabled(collectionId, 'custom_domain') }, [collectionId]); // Elsewhere, read synchronously without an await: const enabled = appConfiguration.isFeatureEnabledSync(collectionId, 'custom_domain'); if (enabled === undefined) { // not warmed yet — fall back to a loading state or the async version } ```
 
+**resolveEnabled**(cfg: { enabled?: Record<string, boolean> } | null | undefined, key: string) → `boolean`
+Has the collection SWITCHED ON this part of the platform (`appConfig.enabled[key]`)? A missing key is on — only an explicit `false` is off. This is "does this business use it", not "does the plan allow it": for something a plan gates, check `resolveFeature()` as well. docs/appConfig.md §8a.
+
+**isEnabled**(collectionId: string, key: string, options?: { force?: boolean }) → `Promise<boolean>`
+Has the collection switched on `key` (`products`, `crm`, `analytics`, `hub`, `portal`, `printStudio`, or an app's own key)? Hide what's off: a website-only business switches off products and the CRM, so menus, cards and setup steps for them shouldn't appear. ```typescript if (await appConfiguration.isEnabled(collectionId, 'products')) showProductsMenu(); ```
+
+**isEnabledSync**(collectionId: string, key: string) → `boolean | undefined`
+Cache-only `isEnabled` — `undefined` until `getAppConfig()` has been read this page load.
+
 ### asset
 
 **upload**(options: UploadAssetOptions) → `Promise<Asset>`

package/docs/appConfig.md

@@ -36,6 +36,8 @@ export interface AppConfigSettings {
 
   /** How the account handles individual physical items. */
   itemRecordMode?: 'registered' | 'owned' | null;
+  /** What the collection has switched on (absent key = on) — see §8a. */
+  enabled?: Record<string, boolean>;
 
   // ── SYSTEM-OWNED, PUBLIC (reconcile writes; client read-only) ─────
   /** Resolved entitlement truth. Read this to gate features. */
@@ -501,6 +503,41 @@ the customer add-ons page (`src/components/pricing/ItemHandlingSection`)
 because these settings change the whole UX shape (claim, ownership,
 CRM visibility), not just a capability flag.
 
+## 8a. What's switched on (`enabled`)
+
+A root-level, user-owned map (like `itemRecordMode`; reconcile never touches it) saying which parts of
+the platform this collection **uses** — separate from what its plan **allows** (`system.features`):
+
+| | Plan allows (`system.features`) | Switched on (`enabled`) |
+|---|---|---|
+| Written by | billing (`entitlements-reconcile`) | the collection: sign-up wizards, admins |
+| Means | "you may have this" | "this business uses this" |
+| Missing key | standard: off · enterprise: on | **on** |
+
+```json
+{ "enabled": { "products": false, "crm": false, "hub": false, "portal": false, "printStudio": false } }
+```
+
+**A missing key is on**, so a collection that never set `enabled` behaves exactly as before. Only an
+explicit `false` switches something off. A website-only sign-up switches off what it doesn't use
+(products, CRM, Hub, Portal…), and Studio hides the menus, dashboard cards and setup steps for them;
+an admin can switch them back on.
+
+Known keys: `products`, `crm`, `analytics`, `hub`, `portal`, `printStudio`. The map is open — an app
+may define its own key.
+
+```ts
+if (await SL.appConfiguration.isEnabled(collectionId, 'products')) showProducts()
+// already have the config:
+SL.appConfiguration.resolveEnabled(cfg, 'crm')
+```
+
+For something a plan gates, show it only when both hold: `resolveEnabled(cfg, key)` **and**
+`resolveFeature(cfg.system, flag)`.
+
+Write it through the admin settings route (`collection.updateSettings(collectionId, 'appConfig',
+{ enabled: { products: true } })`) — keys merge, so set only the ones you change.
+
 ## 9. Migration notes
 
 - Legacy `entitlements` settings group is deprecated. Everything moved

package/openapi.yaml

@@ -19168,6 +19168,10 @@ components:
           enum:
             - registered
             - owned
+        enabled:
+          type: object
+          additionalProperties:
+            type: boolean
         system:
           $ref: "#/components/schemas/SystemBlock"
       required:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "2.0.65",
+  "version": "2.0.66",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "type": "module",
   "main": "dist/index.js",