@proveanything/smartlinks 2.0.63 → 2.0.64

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.64  |  Generated: 2026-10-14T09:37:13.261Z
 
 This is a concise summary of all available API functions and types.
 
@@ -3095,6 +3095,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/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

@@ -20172,6 +20172,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/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.64  |  Generated: 2026-10-14T09:37:13.261Z
 
 This is a concise summary of all available API functions and types.
 
@@ -3095,6 +3095,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/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

@@ -20172,6 +20172,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.64",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "type": "module",
   "main": "dist/index.js",