@proveanything/smartlinks 2.0.63 → 2.0.65

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/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.0.63  |  Generated: 2026-10-14T09:04:47.371Z
+Version: 2.0.65  |  Generated: 2026-10-14T11:51:48.823Z
 
 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 }[]
@@ -3095,6 +3106,8 @@ interface ConnectorShapeResult {
 interface ConnectorSerializeInput {
   installation: ConnectorInstallation
   documents: Array<Record<string, unknown>>
+  entities?: Array<{ id: string | null; name?: string | null; deleted?: boolean }>
+  targetOptions?: Record<string, Record<string, unknown>>
   eventType?: string
 }
 ```

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/connectors.md

@@ -110,7 +110,7 @@ declare the provider's hosts (`network:<host>`) and the secrets it reads (`secre
 | `sample` | Mapper, AI assist, dry run | `{ installation, limit }` | `ConnectorRecords` `{ records }`: real provider records |
 | `fetch` | Every inbound run | `ConnectorFetchInput` `{ installation, cursor, limit }` | `ConnectorRecords` `{ records, nextCursor }`: one page per call |
 | `shape` | Every inbound run (and sample dry runs) | `ConnectorShapeInput` `{ installation, records }` | `ConnectorShapeResult` `{ documents, skipped }`: one provider-neutral document per record, same order; `null` skips one |
-| `serialize` | Every outbound run | `ConnectorSerializeInput` `{ installation, documents, eventType? }`: documents core mapped to `describeTarget` paths; a deletion arrives as `{ id, _deleted: true }` | `ConnectorSerializeResult` `{ payloads, skipped }`: one provider payload per document, same order; `null` skips one |
+| `serialize` | Every outbound run | `ConnectorSerializeInput` `{ installation, documents, entities, targetOptions, eventType? }`: documents core mapped to `describeTarget` paths; `entities` = the SmartLinks record each came from (id, name); `targetOptions` = per-field options the mapping carries (e.g. locale, unit); a deletion arrives as `{ id, _deleted: true }` | `ConnectorSerializeResult` `{ payloads, skipped }`: one provider payload per document, same order; `null` skips one |
 | `send` | Every outbound run | `ConnectorSendInput` `{ installation, payloads }` | `ConnectorSendResult` `{ results: [{ index, ok, status, error, externalId }] }` |
 
 **How a run flows:**

package/dist/docs/server-functions.md

@@ -167,6 +167,7 @@ Declare the minimum you need.
 | `sl:<resource>:read` / `sl:<resource>:write` | SDK access to that resource, e.g. `sl:products:read`, `sl:records:write`, `sl:attestations:write`, `sl:contacts:write`. |
 | `network` | `ctx.fetch` to any host. |
 | `network:<host>` | `ctx.fetch` to that host only (repeat for several). Prefer this over blanket `network`. |
+| `network:*.<domain>` | `ctx.fetch` to any subdomain of `<domain>` (not `<domain>` itself), for a customer's own endpoint at a provider, e.g. `network:*.servicebus.windows.net`. `<domain>` needs at least two labels (`*.com` is not honoured). |
 | `secrets:<name>` | `ctx.secrets.get('<name>')` for that one secret (see [Secrets](#secrets--api-keys-per-collection)). |
 
 If you don't declare `network`, `ctx.fetch` is absent. Reading a secret you didn't declare with

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:
@@ -20172,6 +20218,16 @@ components:
           items:
             type: object
             additionalProperties: true
+        entities:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
+        targetOptions:
+          type: object
+          additionalProperties:
+            type: object
+            additionalProperties: true
         eventType:
           type: string
       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/appManifest.d.ts

@@ -1010,6 +1010,17 @@ export interface ConnectorShapeResult {
 export interface ConnectorSerializeInput {
     installation: ConnectorInstallation;
     documents: Array<Record<string, unknown>>;
+    /** The SmartLinks record each document came from (same order): its id and name, e.g. for an envelope's own id. */
+    entities?: Array<{
+        id: string | null;
+        name?: string | null;
+        deleted?: boolean;
+    }>;
+    /**
+     * Options the flow's mapping carries per target field (keyed by target path), beyond the mapping
+     * itself — e.g. { "brand": { "locale": "en-GB", "uom": "kg" } }. Data for the wire format, not mapping logic.
+     */
+    targetOptions?: Record<string, Record<string, unknown>>;
     /** The event that triggered the run, e.g. 'product.updated' (absent for manual / scheduled runs). */
     eventType?: string;
 }

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.0.63  |  Generated: 2026-10-14T09:04:47.371Z
+Version: 2.0.65  |  Generated: 2026-10-14T11:51:48.823Z
 
 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 }[]
@@ -3095,6 +3106,8 @@ interface ConnectorShapeResult {
 interface ConnectorSerializeInput {
   installation: ConnectorInstallation
   documents: Array<Record<string, unknown>>
+  entities?: Array<{ id: string | null; name?: string | null; deleted?: boolean }>
+  targetOptions?: Record<string, Record<string, unknown>>
   eventType?: string
 }
 ```

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/connectors.md

@@ -110,7 +110,7 @@ declare the provider's hosts (`network:<host>`) and the secrets it reads (`secre
 | `sample` | Mapper, AI assist, dry run | `{ installation, limit }` | `ConnectorRecords` `{ records }`: real provider records |
 | `fetch` | Every inbound run | `ConnectorFetchInput` `{ installation, cursor, limit }` | `ConnectorRecords` `{ records, nextCursor }`: one page per call |
 | `shape` | Every inbound run (and sample dry runs) | `ConnectorShapeInput` `{ installation, records }` | `ConnectorShapeResult` `{ documents, skipped }`: one provider-neutral document per record, same order; `null` skips one |
-| `serialize` | Every outbound run | `ConnectorSerializeInput` `{ installation, documents, eventType? }`: documents core mapped to `describeTarget` paths; a deletion arrives as `{ id, _deleted: true }` | `ConnectorSerializeResult` `{ payloads, skipped }`: one provider payload per document, same order; `null` skips one |
+| `serialize` | Every outbound run | `ConnectorSerializeInput` `{ installation, documents, entities, targetOptions, eventType? }`: documents core mapped to `describeTarget` paths; `entities` = the SmartLinks record each came from (id, name); `targetOptions` = per-field options the mapping carries (e.g. locale, unit); a deletion arrives as `{ id, _deleted: true }` | `ConnectorSerializeResult` `{ payloads, skipped }`: one provider payload per document, same order; `null` skips one |
 | `send` | Every outbound run | `ConnectorSendInput` `{ installation, payloads }` | `ConnectorSendResult` `{ results: [{ index, ok, status, error, externalId }] }` |
 
 **How a run flows:**

package/docs/server-functions.md

@@ -167,6 +167,7 @@ Declare the minimum you need.
 | `sl:<resource>:read` / `sl:<resource>:write` | SDK access to that resource, e.g. `sl:products:read`, `sl:records:write`, `sl:attestations:write`, `sl:contacts:write`. |
 | `network` | `ctx.fetch` to any host. |
 | `network:<host>` | `ctx.fetch` to that host only (repeat for several). Prefer this over blanket `network`. |
+| `network:*.<domain>` | `ctx.fetch` to any subdomain of `<domain>` (not `<domain>` itself), for a customer's own endpoint at a provider, e.g. `network:*.servicebus.windows.net`. `<domain>` needs at least two labels (`*.com` is not honoured). |
 | `secrets:<name>` | `ctx.secrets.get('<name>')` for that one secret (see [Secrets](#secrets--api-keys-per-collection)). |
 
 If you don't declare `network`, `ctx.fetch` is absent. Reading a secret you didn't declare with

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:
@@ -20172,6 +20218,16 @@ components:
           items:
             type: object
             additionalProperties: true
+        entities:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
+        targetOptions:
+          type: object
+          additionalProperties:
+            type: object
+            additionalProperties: true
         eventType:
           type: string
       required:

package/package.json

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