@proveanything/smartlinks 2.0.64 → 2.0.66

package/dist/ai-tools.js

@@ -82,9 +82,9 @@ export const BUILTIN_AI_TOOLS = [
     { name: 'pdf.edit', group: 'media', capabilities: ['web:read', 'media:pdf'],
         description: 'Edit an existing PDF: replace LIVE text (glyph-exact removal so neighbouring text never moves; redrawn in the original font when it has the glyphs, else an embedded fallback; CMYK/spot colour kept; matches may span lines), add text and images in boxes (cmyk converts images for print). Returns url + per-item results with verified flags. Outlined text cannot be edited.' },
     { name: 'pdf.preflight', group: 'media', capabilities: ['web:read'],
-        description: 'Prepress preflight without changing the PDF: non-embedded fonts, RGB/Lab content, missing TrimBox/BleedBox and short bleed, low effective image resolution, transparency, white overprint, missing PDF/X output intent. Severity follows the target profile. No AI.' },
+        description: 'Prepress preflight without changing the PDF: non-embedded fonts, RGB/Lab content, missing TrimBox/BleedBox and short bleed, low effective image resolution, transparency, white overprint, annotations, hidden layers, missing PDF/X output intent. Severity follows the target profile. No AI.' },
     { name: 'pdf.printReady', group: 'media', capabilities: ['web:read', 'media:pdf'],
-        description: 'Prepare a PDF for print: RGB/Lab -> CMYK with a real press profile (spot colours kept), embed fonts, optional transparency flattening, mark as PDF/X-1a or PDF/X-4 with the output intent embedded, then preflight the RESULT. Returns url + report { compliant, findings, changes }.' },
+        description: 'Prepare a PDF for print: text outlined to curves (or live embedded fonts), RGB/Lab -> CMYK with a real press profile (or grey), spot colours kept or converted, comments removed, layers chosen by name, optional image downsampling, page selection, boxes from included bleed, crop marks and transparency flattening; mark as PDF/X-1a or PDF/X-4 with the output intent embedded, then preflight the RESULT. Returns url + report { compliant, findings, changes }.' },
     { name: 'http.request', group: 'net', capabilities: ['net:http'],
         description: 'SSRF-guarded outbound HTTP(S) request to a public URL; returns status/headers/body.' },
     { name: 'translate', group: 'text', capabilities: ['ai:text'],

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.64  |  Generated: 2026-10-14T09:37:13.261Z
+Version: 2.0.66  |  Generated: 2026-10-14T17:03:31.949Z
 
 This is a concise summary of all available API functions and types.
 
@@ -1688,13 +1688,22 @@ interface PdfPreflightArgs {
 ```typescript
 interface PdfPrintReadyArgs {
   url: string
-  profile?: PdfXProfile
+  profile?: PdfXProfile | 'none'
   outputIntent?: string
-  convertToCmyk?: boolean
+  colour?: 'cmyk' | 'gray' | 'keep'
+  spotColours?: 'keep' | 'convert'
+  outlineFonts?: boolean
   embedFonts?: boolean
+  downsample?: { dpi: number }
+  pages?: string
+  annotations?: 'remove' | 'flatten' | 'keep'
+  layers?: { hide?: string[]; show?: string[] }
   bleed?: { mm: number }
+  bleedIncluded?: { mm: number; force?: boolean }
+  cropMarks?: { offsetMm?: number; lengthMm?: number; weightPt?: number }
   flattenTransparency?: boolean
   minDpi?: number
+  title?: string
 }
 ```
 
@@ -1954,6 +1963,8 @@ interface PdfPreflightResult {
   images: { page: number; dpi: number; width: number; height: number; space: string; placedMm: { w: number; h: number } }[]
   transparency: boolean
   outputIntent: { identifier: string | null; hasProfile: boolean } | null
+  annotations: number
+  layers: { name: string; visible: boolean }[]
   [key: string]: any
   }
 }
@@ -1965,7 +1976,7 @@ interface PdfPrintReadyResult {
   url: string
   report: {
   compliant: boolean
-  profile: PdfXProfile
+  profile: PdfXProfile | 'none'
   outputIntent: string
   findings: PdfPreflightFinding[]
   changes: { code: string; message: string }[]
@@ -2468,6 +2479,7 @@ interface AppConfigSettings {
   addOns?: string[]
   requestedBasePlanId?: string
   itemRecordMode?: 'registered' | 'owned' | null
+  enabled?: Record<string, boolean>
   system?: SystemBlock
 }
 ```
@@ -10875,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/admin-cards.md

@@ -86,7 +86,9 @@ Data that changes without an event (visit counts, "due this week") — use `maxA
 
 ## Return the payload
 
-The function returns an `AdminCardPayload` — every field optional; return what the card needs:
+The function returns an `AdminCardPayload` — every field optional; return what the card needs.
+It's called with **POST** (an http function's default method — no `trigger.methods` needed) and the body
+`{ "card": "<card id>" }`, so one function can serve several cards:
 
 ```ts
 import type { AdminCardPayload } from '@proveanything/smartlinks'

package/dist/docs/ai.md

@@ -333,8 +333,8 @@ in `input`.
 | `pdf.decodeBarcodes` | Deterministically decode barcodes/QR on a page (WASM, no AI) → value + symbology + page + bbox + confidence. Use this for barcode digits, never vision. |
 | `pdf.inspectGraphics` | Prepress inspection: per-page path/image/outlined-text counts + colour spaces, plus named SPOT colours (e.g. "PANTONE 871 C"). No AI. |
 | `pdf.edit` | Edit an existing PDF: replace **live** text (glyph-exact removal, neighbours never move; original font when it has the glyphs, else an embedded fallback; CMYK/spot colour kept; matches may span lines), add text / images in boxes (`colorSpace: "cmyk"` converts images for print). Per-item `results` with `verified`. |
-| `pdf.preflight` | Prepress preflight, no changes: fonts, RGB/Lab, TrimBox/BleedBox + bleed, effective image dpi, transparency, white overprint, output intent. No AI. |
-| `pdf.printReady` | RGB→CMYK with a press profile (spot colours kept), embed fonts, optional flattening, mark PDF/X-1a or PDF/X-4 with the output intent embedded, then preflight the result → `{ url, report }`. |
+| `pdf.preflight` | Prepress preflight, no changes: fonts, RGB/Lab, TrimBox/BleedBox + bleed, effective image dpi, transparency, white overprint, annotations, hidden layers, output intent. No AI. |
+| `pdf.printReady` | Text outlined to curves, RGB→CMYK with a press profile (spot colours kept), comments removed, layers merged as chosen, mark PDF/X-1a or PDF/X-4 with the output intent embedded, then preflight the result → `{ url, report }`. Options for grey, spot conversion, downsampling, pages, crop marks and more (below). |
 | `http.request` | SSRF-guarded outbound HTTP(S) to a public URL (call a REST API). |
 | `translate` | Translate text into one or more languages (generic, model-based). |
 
@@ -362,11 +362,31 @@ in `input`.
   — it may run into neighbouring text. Text outlined to curves can't be edited: the item fails with
   "not found as live text" — put it on the designer change list. `verified: true` means the new text
   reads back from the output.
-- **Is it print-ready?** → `pdf.preflight` (report only). **Make it print-ready** → `pdf.printReady`
-  with `profile` (`pdfx-4` default; `pdfx-1a` for CMYK-only workflows), `outputIntent` (e.g. `FOGRA39`)
-  and `bleed: { mm: 3 }`. `report.compliant` comes from preflighting the OUTPUT, so remaining issues
-  (low-res images, missing bleed, white overprint) are reported rather than hidden. Flattening for
-  PDF/X-1a turns affected pages into images — opt in with `flattenTransparency: true`.
+- **Is it print-ready?** → `pdf.preflight` (report only; `stats.layers` lists the file's layers).
+  **Make it print-ready** → `pdf.printReady`. By default it outlines all text to curves, converts
+  RGB/Lab to CMYK for the `outputIntent` (e.g. `FOGRA39`), keeps spot colours, removes comments and
+  links, merges layers as the file shows them (hidden layers left out) and marks the file PDF/X-4.
+  `report.changes` says what was done, measured on the output; `report.compliant` comes from
+  preflighting the OUTPUT, so remaining issues (low-res images, missing bleed, white overprint) are
+  reported rather than hidden. Options:
+
+  | Option | Values |
+  |---|---|
+  | `profile` | `pdfx-4` (default), `pdfx-1a` (CMYK + spot only), `none` (convert, no PDF/X marking) |
+  | `outputIntent` | `FOGRA39` (default), `FOGRA51`, `FOGRA52`, `FOGRA29`, `GRACoL2006`, `SWOP2006`, `JapanColor2011` |
+  | `colour` | `cmyk` (default), `gray`, `keep` |
+  | `spotColours` | `keep` (default) or `convert` to process colour |
+  | `outlineFonts` | `true` (default) text → curves; `false` keeps live text (fonts embedded with `embedFonts`, default true) |
+  | `layers` | `{ hide: ['Dieline'], show: [...] }` by name — e.g. print without the dieline |
+  | `annotations` | `remove` (default), `flatten` (draw into the artwork), `keep` |
+  | `pages` | `"1-3,5"` (default all) |
+  | `downsample` | `{ dpi: 300 }` — resample images placed above 1.5× that; off by default |
+  | `bleed` | `{ mm: 3 }` — required bleed, checked and reported, never added |
+  | `bleedIncluded` | `{ mm: 3 }` — the artwork already includes its bleed: sets TrimBox/BleedBox |
+  | `cropMarks` | `{}` or `{ offsetMm, lengthMm, weightPt }` — crop marks outside the bleed |
+  | `flattenTransparency` | PDF/X-1a only: affected pages become images. Default false |
+
+  Outlined text can't be edited or searched afterwards: keep the source PDF for changes and regenerate.
 
 ```ts
 const edited = await SL.ai.tools.run(collectionId, 'pdf.edit', {
@@ -375,6 +395,7 @@ const edited = await SL.ai.tools.run(collectionId, 'pdf.edit', {
 })
 const ready = await SL.ai.tools.run(collectionId, 'pdf.printReady', {
   url: edited.result.url, profile: 'pdfx-4', outputIntent: 'FOGRA39', bleed: { mm: 3 },
+  layers: { hide: ['Dieline'] }, cropMarks: {},
 })
 if (!ready.result.report.compliant) showFindings(ready.result.report.findings)
 ```

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

@@ -17615,20 +17615,55 @@ components:
         url:
           type: string
         profile:
-          $ref: "#/components/schemas/PdfXProfile"
+          type: string
+          enum:
+            - none
         outputIntent:
           type: string
-        convertToCmyk:
+        colour:
+          type: string
+          enum:
+            - cmyk
+            - gray
+            - keep
+        spotColours:
+          type: string
+          enum:
+            - keep
+            - convert
+        outlineFonts:
           type: boolean
         embedFonts:
           type: boolean
+        downsample:
+          type: object
+          additionalProperties: true
+        pages:
+          type: string
+        annotations:
+          type: string
+          enum:
+            - remove
+            - flatten
+            - keep
+        layers:
+          type: object
+          additionalProperties: true
         bleed:
           type: object
           additionalProperties: true
+        bleedIncluded:
+          type: object
+          additionalProperties: true
+        cropMarks:
+          type: object
+          additionalProperties: true
         flattenTransparency:
           type: boolean
         minDpi:
           type: number
+        title:
+          type: string
       required:
         - url
     HttpRequestArgs:
@@ -18040,6 +18075,13 @@ components:
         outputIntent:
           type: object
           additionalProperties: true
+        annotations:
+          type: number
+        layers:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
       required:
         - url
         - compliant
@@ -18053,6 +18095,8 @@ components:
         - images
         - transparency
         - outputIntent
+        - annotations
+        - layers
     PdfPrintReadyResult:
       type: object
       properties:
@@ -18064,7 +18108,9 @@ components:
         compliant:
           type: boolean
         profile:
-          $ref: "#/components/schemas/PdfXProfile"
+          type: string
+          enum:
+            - none
         outputIntent:
           type: string
         findings:
@@ -19122,6 +19168,10 @@ components:
           enum:
             - registered
             - owned
+        enabled:
+          type: object
+          additionalProperties:
+            type: boolean
         system:
           $ref: "#/components/schemas/SystemBlock"
       required:

package/dist/types/ai.d.ts

@@ -1041,19 +1041,51 @@ export interface PdfPreflightArgs {
 }
 export interface PdfPrintReadyArgs {
     url: string;
-    /** Default 'pdfx-4' (keeps live transparency); 'pdfx-1a' = CMYK + spot only, no transparency. */
-    profile?: PdfXProfile;
+    /** Default 'pdfx-4' (keeps live transparency); 'pdfx-1a' = CMYK + spot only, no transparency; 'none' = convert without PDF/X marking. */
+    profile?: PdfXProfile | 'none';
     /** FOGRA39 (default), FOGRA51, FOGRA52, FOGRA29, GRACoL2006, SWOP2006, JapanColor2011. */
     outputIntent?: string;
-    convertToCmyk?: boolean;
+    /** 'cmyk' (default: RGB/Lab → CMYK with the press profile), 'gray' (single-colour jobs), 'keep'. */
+    colour?: 'cmyk' | 'gray' | 'keep';
+    /** 'keep' (default) the spot plates (Pantone, varnish, white, dieline) or 'convert' them to process colour. */
+    spotColours?: 'keep' | 'convert';
+    /** Convert all text to vector curves so no fonts are needed (default true). false keeps live text. */
+    outlineFonts?: boolean;
+    /** With outlineFonts false: embed (subset) every font (default true). */
     embedFonts?: boolean;
-    /** Checked and reported, never added. */
+    /** Resample images placed above 1.5× this resolution down to it (e.g. { dpi: 300 }). Off by default. */
+    downsample?: {
+        dpi: number;
+    };
+    /** Pages to keep, e.g. "1-3,5" (default all). */
+    pages?: string;
+    /** Comments, links and form fields: 'remove' (default), 'flatten' (drawn into the artwork), 'keep'. */
+    annotations?: 'remove' | 'flatten' | 'keep';
+    /** Choose which layers print, by name (case-insensitive), e.g. { hide: ['Dieline'] }. Layers are merged into the artwork; hidden ones are left out. */
+    layers?: {
+        hide?: string[];
+        show?: string[];
+    };
+    /** Required bleed — checked and reported, never added. */
     bleed?: {
         mm: number;
     };
+    /** The artwork already includes this much bleed (page = finished size + bleed): sets TrimBox/BleedBox (pages without a TrimBox; all with force). */
+    bleedIncluded?: {
+        mm: number;
+        force?: boolean;
+    };
+    /** Add crop marks outside the bleed in registration colour; {} for defaults (3 mm offset, 5 mm long, 0.25 pt). */
+    cropMarks?: {
+        offsetMm?: number;
+        lengthMm?: number;
+        weightPt?: number;
+    };
     /** pdfx-1a only: flatten transparency (affected pages become images). Default false. */
     flattenTransparency?: boolean;
     minDpi?: number;
+    /** Document title written into the file (default: the source title). */
+    title?: string;
 }
 export interface HttpRequestArgs {
     url: string;
@@ -1332,6 +1364,13 @@ export interface PdfPreflightResult {
             identifier: string | null;
             hasProfile: boolean;
         } | null;
+        /** Comments, links and form fields on the pages (printer's marks / trapping excluded). */
+        annotations: number;
+        /** Optional content (layers) and whether each is visible in the default view. */
+        layers: {
+            name: string;
+            visible: boolean;
+        }[];
         [key: string]: any;
     };
 }
@@ -1340,9 +1379,10 @@ export interface PdfPrintReadyResult {
     report: {
         /** From the post-conversion preflight — never assumed. */
         compliant: boolean;
-        profile: PdfXProfile;
+        profile: PdfXProfile | 'none';
         outputIntent: string;
         findings: PdfPreflightFinding[];
+        /** What was done, measured on the result: FONTS_OUTLINED, CONVERTED_TO_CMYK, SPOT_COLOURS_CONVERTED, IMAGES_DOWNSAMPLED, PAGES_SELECTED, ANNOTATIONS_REMOVED, LAYERS_MERGED, BOXES_FROM_BLEED, CROP_MARKS, OUTPUT_INTENT, PDFX_IDENTIFIED… */
         changes: {
             code: string;
             message: string;

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.64  |  Generated: 2026-10-14T09:37:13.261Z
+Version: 2.0.66  |  Generated: 2026-10-14T17:03:31.949Z
 
 This is a concise summary of all available API functions and types.
 
@@ -1688,13 +1688,22 @@ interface PdfPreflightArgs {
 ```typescript
 interface PdfPrintReadyArgs {
   url: string
-  profile?: PdfXProfile
+  profile?: PdfXProfile | 'none'
   outputIntent?: string
-  convertToCmyk?: boolean
+  colour?: 'cmyk' | 'gray' | 'keep'
+  spotColours?: 'keep' | 'convert'
+  outlineFonts?: boolean
   embedFonts?: boolean
+  downsample?: { dpi: number }
+  pages?: string
+  annotations?: 'remove' | 'flatten' | 'keep'
+  layers?: { hide?: string[]; show?: string[] }
   bleed?: { mm: number }
+  bleedIncluded?: { mm: number; force?: boolean }
+  cropMarks?: { offsetMm?: number; lengthMm?: number; weightPt?: number }
   flattenTransparency?: boolean
   minDpi?: number
+  title?: string
 }
 ```
 
@@ -1954,6 +1963,8 @@ interface PdfPreflightResult {
   images: { page: number; dpi: number; width: number; height: number; space: string; placedMm: { w: number; h: number } }[]
   transparency: boolean
   outputIntent: { identifier: string | null; hasProfile: boolean } | null
+  annotations: number
+  layers: { name: string; visible: boolean }[]
   [key: string]: any
   }
 }
@@ -1965,7 +1976,7 @@ interface PdfPrintReadyResult {
   url: string
   report: {
   compliant: boolean
-  profile: PdfXProfile
+  profile: PdfXProfile | 'none'
   outputIntent: string
   findings: PdfPreflightFinding[]
   changes: { code: string; message: string }[]
@@ -2468,6 +2479,7 @@ interface AppConfigSettings {
   addOns?: string[]
   requestedBasePlanId?: string
   itemRecordMode?: 'registered' | 'owned' | null
+  enabled?: Record<string, boolean>
   system?: SystemBlock
 }
 ```
@@ -10875,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/admin-cards.md

@@ -86,7 +86,9 @@ Data that changes without an event (visit counts, "due this week") — use `maxA
 
 ## Return the payload
 
-The function returns an `AdminCardPayload` — every field optional; return what the card needs:
+The function returns an `AdminCardPayload` — every field optional; return what the card needs.
+It's called with **POST** (an http function's default method — no `trigger.methods` needed) and the body
+`{ "card": "<card id>" }`, so one function can serve several cards:
 
 ```ts
 import type { AdminCardPayload } from '@proveanything/smartlinks'

package/docs/ai.md

@@ -333,8 +333,8 @@ in `input`.
 | `pdf.decodeBarcodes` | Deterministically decode barcodes/QR on a page (WASM, no AI) → value + symbology + page + bbox + confidence. Use this for barcode digits, never vision. |
 | `pdf.inspectGraphics` | Prepress inspection: per-page path/image/outlined-text counts + colour spaces, plus named SPOT colours (e.g. "PANTONE 871 C"). No AI. |
 | `pdf.edit` | Edit an existing PDF: replace **live** text (glyph-exact removal, neighbours never move; original font when it has the glyphs, else an embedded fallback; CMYK/spot colour kept; matches may span lines), add text / images in boxes (`colorSpace: "cmyk"` converts images for print). Per-item `results` with `verified`. |
-| `pdf.preflight` | Prepress preflight, no changes: fonts, RGB/Lab, TrimBox/BleedBox + bleed, effective image dpi, transparency, white overprint, output intent. No AI. |
-| `pdf.printReady` | RGB→CMYK with a press profile (spot colours kept), embed fonts, optional flattening, mark PDF/X-1a or PDF/X-4 with the output intent embedded, then preflight the result → `{ url, report }`. |
+| `pdf.preflight` | Prepress preflight, no changes: fonts, RGB/Lab, TrimBox/BleedBox + bleed, effective image dpi, transparency, white overprint, annotations, hidden layers, output intent. No AI. |
+| `pdf.printReady` | Text outlined to curves, RGB→CMYK with a press profile (spot colours kept), comments removed, layers merged as chosen, mark PDF/X-1a or PDF/X-4 with the output intent embedded, then preflight the result → `{ url, report }`. Options for grey, spot conversion, downsampling, pages, crop marks and more (below). |
 | `http.request` | SSRF-guarded outbound HTTP(S) to a public URL (call a REST API). |
 | `translate` | Translate text into one or more languages (generic, model-based). |
 
@@ -362,11 +362,31 @@ in `input`.
   — it may run into neighbouring text. Text outlined to curves can't be edited: the item fails with
   "not found as live text" — put it on the designer change list. `verified: true` means the new text
   reads back from the output.
-- **Is it print-ready?** → `pdf.preflight` (report only). **Make it print-ready** → `pdf.printReady`
-  with `profile` (`pdfx-4` default; `pdfx-1a` for CMYK-only workflows), `outputIntent` (e.g. `FOGRA39`)
-  and `bleed: { mm: 3 }`. `report.compliant` comes from preflighting the OUTPUT, so remaining issues
-  (low-res images, missing bleed, white overprint) are reported rather than hidden. Flattening for
-  PDF/X-1a turns affected pages into images — opt in with `flattenTransparency: true`.
+- **Is it print-ready?** → `pdf.preflight` (report only; `stats.layers` lists the file's layers).
+  **Make it print-ready** → `pdf.printReady`. By default it outlines all text to curves, converts
+  RGB/Lab to CMYK for the `outputIntent` (e.g. `FOGRA39`), keeps spot colours, removes comments and
+  links, merges layers as the file shows them (hidden layers left out) and marks the file PDF/X-4.
+  `report.changes` says what was done, measured on the output; `report.compliant` comes from
+  preflighting the OUTPUT, so remaining issues (low-res images, missing bleed, white overprint) are
+  reported rather than hidden. Options:
+
+  | Option | Values |
+  |---|---|
+  | `profile` | `pdfx-4` (default), `pdfx-1a` (CMYK + spot only), `none` (convert, no PDF/X marking) |
+  | `outputIntent` | `FOGRA39` (default), `FOGRA51`, `FOGRA52`, `FOGRA29`, `GRACoL2006`, `SWOP2006`, `JapanColor2011` |
+  | `colour` | `cmyk` (default), `gray`, `keep` |
+  | `spotColours` | `keep` (default) or `convert` to process colour |
+  | `outlineFonts` | `true` (default) text → curves; `false` keeps live text (fonts embedded with `embedFonts`, default true) |
+  | `layers` | `{ hide: ['Dieline'], show: [...] }` by name — e.g. print without the dieline |
+  | `annotations` | `remove` (default), `flatten` (draw into the artwork), `keep` |
+  | `pages` | `"1-3,5"` (default all) |
+  | `downsample` | `{ dpi: 300 }` — resample images placed above 1.5× that; off by default |
+  | `bleed` | `{ mm: 3 }` — required bleed, checked and reported, never added |
+  | `bleedIncluded` | `{ mm: 3 }` — the artwork already includes its bleed: sets TrimBox/BleedBox |
+  | `cropMarks` | `{}` or `{ offsetMm, lengthMm, weightPt }` — crop marks outside the bleed |
+  | `flattenTransparency` | PDF/X-1a only: affected pages become images. Default false |
+
+  Outlined text can't be edited or searched afterwards: keep the source PDF for changes and regenerate.
 
 ```ts
 const edited = await SL.ai.tools.run(collectionId, 'pdf.edit', {
@@ -375,6 +395,7 @@ const edited = await SL.ai.tools.run(collectionId, 'pdf.edit', {
 })
 const ready = await SL.ai.tools.run(collectionId, 'pdf.printReady', {
   url: edited.result.url, profile: 'pdfx-4', outputIntent: 'FOGRA39', bleed: { mm: 3 },
+  layers: { hide: ['Dieline'] }, cropMarks: {},
 })
 if (!ready.result.report.compliant) showFindings(ready.result.report.findings)
 ```

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

@@ -17615,20 +17615,55 @@ components:
         url:
           type: string
         profile:
-          $ref: "#/components/schemas/PdfXProfile"
+          type: string
+          enum:
+            - none
         outputIntent:
           type: string
-        convertToCmyk:
+        colour:
+          type: string
+          enum:
+            - cmyk
+            - gray
+            - keep
+        spotColours:
+          type: string
+          enum:
+            - keep
+            - convert
+        outlineFonts:
           type: boolean
         embedFonts:
           type: boolean
+        downsample:
+          type: object
+          additionalProperties: true
+        pages:
+          type: string
+        annotations:
+          type: string
+          enum:
+            - remove
+            - flatten
+            - keep
+        layers:
+          type: object
+          additionalProperties: true
         bleed:
           type: object
           additionalProperties: true
+        bleedIncluded:
+          type: object
+          additionalProperties: true
+        cropMarks:
+          type: object
+          additionalProperties: true
         flattenTransparency:
           type: boolean
         minDpi:
           type: number
+        title:
+          type: string
       required:
         - url
     HttpRequestArgs:
@@ -18040,6 +18075,13 @@ components:
         outputIntent:
           type: object
           additionalProperties: true
+        annotations:
+          type: number
+        layers:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
       required:
         - url
         - compliant
@@ -18053,6 +18095,8 @@ components:
         - images
         - transparency
         - outputIntent
+        - annotations
+        - layers
     PdfPrintReadyResult:
       type: object
       properties:
@@ -18064,7 +18108,9 @@ components:
         compliant:
           type: boolean
         profile:
-          $ref: "#/components/schemas/PdfXProfile"
+          type: string
+          enum:
+            - none
         outputIntent:
           type: string
         findings:
@@ -19122,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.64",
+  "version": "2.0.66",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "type": "module",
   "main": "dist/index.js",