@endora-commerce/mod-linkedin-ads 0.100.0

package/dist/manifest.d.ts

@@ -0,0 +1,195 @@
+/**
+ * LinkedIn Ads module (feature 063). Puts the LinkedIn Insight Tag on the
+ * storefront per sales channel and reports mapped conversions, either from the
+ * browser via `lintrk` or — opt-in per channel — from the backend through
+ * LinkedIn's Conversions API.
+ *
+ * Per-channel configuration is stored through the Settings module; the
+ * Conversions API access token uses the `secret` value type (feature 043,
+ * AES-256-GCM at rest, write-only at the admin boundary).
+ */
+export declare const linkedInAdsSettingsManifest: {
+    moduleCode: string;
+    groups: {
+        code: string;
+        name: string;
+        salesChannelCodes?: string[] | undefined;
+        isSystemProtected?: boolean | undefined;
+    }[];
+    settings: {
+        code: string;
+        name: string;
+        valueType: "string" | "number" | "boolean" | "json" | "string_list" | "secret" | "credential_ref";
+        defaultValue: unknown;
+        description?: string | undefined;
+        groupCode?: string | undefined;
+        previousDefaultValues?: unknown[] | undefined;
+        salesChannelCodes?: string[] | undefined;
+        enumOptions?: string[] | undefined;
+        configurationType?: string | undefined;
+        hidden?: boolean | undefined;
+    }[];
+};
+export declare const LINKEDIN_ADS_READ_PERMISSION = "linkedin_ads:read";
+export declare const LINKEDIN_ADS_WRITE_PERMISSION = "linkedin_ads:write";
+export declare const manifest: {
+    id: string;
+    name: string;
+    version: string;
+    dependencies: string[];
+    description?: string | undefined;
+    acknowledgedDependencies?: {
+        moduleId: string;
+        port: string;
+        reason: string;
+    }[] | undefined;
+    nonBindingDependencies?: {
+        moduleId: string;
+        name: string;
+        kind: "contributes-to" | "degrades-without" | "refuses-without";
+        reason: string;
+        whenAbsent?: string | undefined;
+    }[] | undefined;
+    activation?: {
+        settingCode: string;
+        default: boolean;
+    } | {
+        nonDeactivatable: true;
+        reason: string;
+    } | undefined;
+    settings?: {
+        moduleCode: string;
+        groups: {
+            code: string;
+            name: string;
+            salesChannelCodes?: string[] | undefined;
+            isSystemProtected?: boolean | undefined;
+        }[];
+        settings: {
+            code: string;
+            name: string;
+            valueType: "string" | "number" | "boolean" | "json" | "string_list" | "secret" | "credential_ref";
+            defaultValue: unknown;
+            description?: string | undefined;
+            groupCode?: string | undefined;
+            previousDefaultValues?: unknown[] | undefined;
+            salesChannelCodes?: string[] | undefined;
+            enumOptions?: string[] | undefined;
+            configurationType?: string | undefined;
+            hidden?: boolean | undefined;
+        }[];
+    } | undefined;
+    i18n?: {
+        bundlesDir: string;
+    } | undefined;
+    docs?: false | {
+        dir: string;
+    } | undefined;
+    demo?: false | {
+        summary: string;
+        seed: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoSeedResult>;
+        reset: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoResetResult>;
+        after?: readonly string[] | undefined;
+        package?: string | undefined;
+    } | undefined;
+    actions?: {
+        id: string;
+        labelKey: string;
+        icon: "Plus" | "Sparkles" | "Settings" | "Search" | "Boxes" | "Layers" | "Menu" | "PlusCircle" | "PlusSquare" | "FilePlus" | "FolderPlus" | "Upload" | "FileUp" | "CloudUpload" | "Download" | "FileDown" | "FileText" | "BookOpen" | "Rss" | "Package" | "Tag" | "ShoppingCart" | "Receipt" | "CreditCard" | "Users" | "UserPlus" | "Inbox" | "ListChecks" | "ClipboardList" | "Image" | "Video" | "LayoutDashboard" | "PanelLeft" | "KeyRound" | "ShieldCheck" | "Edit" | "Archive" | "Box" | "Truck" | "CircleDollarSign" | "Activity" | "LineChart" | "Smartphone" | "Webhook" | "Scale" | "PlugZap" | "PercentDiamond" | "Newspaper" | "Languages" | "Eraser" | "Warehouse" | "TrendingDown" | "Bell" | "PackageOpen" | "Building2" | "Store" | "ClipboardCheck";
+        targetRoute: string;
+        keywords: string[];
+        weight: number;
+        descriptionKey?: string | undefined;
+        requiredPermission?: string | undefined;
+    }[] | undefined;
+    permissions?: {
+        code: string;
+        label: string;
+        module?: string | undefined;
+        description?: string | undefined;
+        requires?: string[] | undefined;
+    }[] | undefined;
+    transactionalEmails?: {
+        code: string;
+        name: string;
+        variables: {
+            key: string;
+            label: string;
+            sampleValue?: string | undefined;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        group?: string | undefined;
+    }[] | undefined;
+    capabilities?: string[] | undefined;
+    exclusiveCapabilities?: {
+        key: string;
+        errorCode: string;
+    }[] | undefined;
+    errorCodes?: {
+        code: string;
+        tokens?: string[] | undefined;
+    }[] | undefined;
+    blocks?: {
+        name: string;
+        labelKey: string;
+        category: string;
+        contexts: ("invoice" | "email" | "cms" | "newsletter")[];
+        fields: Record<string, {
+            type: "number" | "object" | "array" | "text" | "textarea" | "select" | "radio" | "external" | "uuid" | "richtext";
+            label?: string | undefined;
+            required?: boolean | undefined;
+            options?: {
+                label: string;
+                value: string | number;
+            }[] | undefined;
+            refKind?: string | undefined;
+        }>;
+        descriptionKey?: string | undefined;
+        defaultProps?: Record<string, unknown> | undefined;
+        responsiveFields?: string[] | undefined;
+        previewIcon?: string | undefined;
+        weight?: number | undefined;
+    }[] | undefined;
+    blockCategories?: {
+        key: string;
+        titleKey: string;
+        contexts: ("invoice" | "email" | "cms" | "newsletter")[];
+        weight?: number | undefined;
+        visible?: boolean | undefined;
+    }[] | undefined;
+    env?: {
+        name: string;
+        describes: {
+            en: string;
+            pl: string;
+        };
+        requirement: {
+            kind: "required";
+        } | {
+            kind: "requiredWhen";
+            input: string;
+            equals: string;
+        } | {
+            kind: "optional";
+            without: {
+                en: string;
+                pl: string;
+            };
+        };
+        secret: boolean;
+        generable: boolean;
+        owner: {
+            kind: "platform";
+        } | {
+            kind: "application";
+            application: "admin" | "backend" | "storefront";
+        } | {
+            kind: "module";
+            moduleId: string;
+        };
+        consumers: ("admin" | "backend" | "storefront")[];
+        addressOf: "admin" | "backend" | "storefront" | null;
+    }[] | undefined;
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;CAkEtC,CAAC;AAEH,eAAO,MAAM,4BAA4B,sBAAsB,CAAC;AAChE,eAAO,MAAM,6BAA6B,uBAAuB,CAAC;AAElE,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CnB,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,119 @@
+import { defineModuleManifest, defineModuleSettingsManifest } from '@endora-commerce/contracts';
+import { LINKEDIN_ADS_SETTING_CODES } from '@endora-commerce/contracts';
+/**
+ * LinkedIn Ads module (feature 063). Puts the LinkedIn Insight Tag on the
+ * storefront per sales channel and reports mapped conversions, either from the
+ * browser via `lintrk` or — opt-in per channel — from the backend through
+ * LinkedIn's Conversions API.
+ *
+ * Per-channel configuration is stored through the Settings module; the
+ * Conversions API access token uses the `secret` value type (feature 043,
+ * AES-256-GCM at rest, write-only at the admin boundary).
+ */
+export const linkedInAdsSettingsManifest = defineModuleSettingsManifest({
+    moduleCode: 'linkedin_ads',
+    groups: [{ code: 'linkedin_ads', name: 'LinkedIn Ads' }],
+    settings: [
+        {
+            // Feature 073 — the operator's activation control. **Platform-wide, and
+            // deliberately NOT `linkedin_ads.enabled`.** That code already exists and
+            // means something else: it is per-sales-channel and answers "is the
+            // tag is live on a given storefront channel". This one answers "does this client have the LinkedIn Ads
+            // capability at all". Adopting the existing code would have collapsed two
+            // orthogonal questions into one switch — and, because an activation
+            // control may only be written through the activation endpoint, would have
+            // made the per-channel setting unwritable through the settings screen.
+            code: 'linkedin_ads.module_enabled',
+            name: 'LinkedIn Ads module enabled',
+            description: 'Switches the LinkedIn Insight Tag, the conversion mappings and the admin screen on or off for the whole platform. Separate from the per-channel switch, which decides where the tag actually loads. Nothing is dropped: mappings stay in the database and every setting keeps its value.',
+            groupCode: 'linkedin_ads',
+            valueType: 'boolean',
+            defaultValue: true,
+        },
+        {
+            code: LINKEDIN_ADS_SETTING_CODES.ENABLED,
+            name: 'Enable LinkedIn Ads',
+            description: 'Master switch for the module. Per-channel overridable.',
+            groupCode: 'linkedin_ads',
+            valueType: 'boolean',
+            defaultValue: false,
+        },
+        {
+            code: LINKEDIN_ADS_SETTING_CODES.PARTNER_ID,
+            name: 'Partner ID',
+            description: 'LinkedIn Insight Tag Partner ID from Campaign Manager. Blank means the channel is untracked.',
+            groupCode: 'linkedin_ads',
+            valueType: 'string',
+            defaultValue: '',
+        },
+        {
+            code: LINKEDIN_ADS_SETTING_CODES.REQUIRE_CONSENT,
+            name: 'Require analytics consent',
+            description: 'When enabled, nothing LinkedIn-related runs until the visitor accepts the cookie banner.',
+            groupCode: 'linkedin_ads',
+            valueType: 'boolean',
+            defaultValue: true,
+        },
+        {
+            code: LINKEDIN_ADS_SETTING_CODES.SERVER_SIDE_ENABLED,
+            name: 'Server-side conversions',
+            description: "Report mapped conversions from the backend through LinkedIn's Conversions API instead of the browser. Requires an access token.",
+            groupCode: 'linkedin_ads',
+            valueType: 'boolean',
+            defaultValue: false,
+        },
+        {
+            code: LINKEDIN_ADS_SETTING_CODES.ACCESS_TOKEN,
+            name: 'Conversions API access token',
+            description: 'OAuth access token authorised for the Conversions API. Stored encrypted at rest; write-only.',
+            groupCode: 'linkedin_ads',
+            valueType: 'secret',
+            defaultValue: '',
+        },
+    ],
+});
+export const LINKEDIN_ADS_READ_PERMISSION = 'linkedin_ads:read';
+export const LINKEDIN_ADS_WRITE_PERMISSION = 'linkedin_ads:write';
+export const manifest = defineModuleManifest({
+    id: 'linkedin_ads',
+    name: 'LinkedIn Ads',
+    description: 'LinkedIn Ads integration: per-sales-channel Insight Tag, consent-gated tracking, configurable conversion mappings, and optional server-side reporting through the Conversions API.',
+    version: '1.0.0',
+    // `auth` owns the `requireAdmin` port the admin routes are gated by; feature
+    // 072 made it a container resolution rather than a constructor argument.
+    dependencies: ['audit_logs', 'sales_channels', 'settings', 'auth'],
+    settings: linkedInAdsSettingsManifest,
+    i18n: { bundlesDir: 'i18n' },
+    docs: { dir: 'docs' },
+    permissions: [
+        { code: LINKEDIN_ADS_READ_PERMISSION, label: 'View LinkedIn Ads configuration' },
+        {
+            code: LINKEDIN_ADS_WRITE_PERMISSION,
+            label: 'Manage LinkedIn Ads configuration and conversion mappings',
+        },
+    ],
+    actions: [
+        {
+            id: 'open-linkedin-ads',
+            labelKey: 'actions.openLinkedInAds.label',
+            descriptionKey: 'actions.openLinkedInAds.description',
+            icon: 'Sparkles',
+            targetRoute: '/linkedin-ads',
+            requiredPermission: LINKEDIN_ADS_READ_PERMISSION,
+            keywords: ['linkedin', 'ads', 'insight tag', 'conversion', 'konwersje', 'reklamy'],
+            weight: 242,
+        },
+        {
+            id: 'new-linkedin-conversion-mapping',
+            labelKey: 'actions.newConversionMapping.label',
+            descriptionKey: 'actions.newConversionMapping.description',
+            icon: 'Plus',
+            targetRoute: '/linkedin-ads/new',
+            requiredPermission: LINKEDIN_ADS_WRITE_PERMISSION,
+            keywords: ['linkedin', 'conversion', 'mapping', 'konwersja', 'mapowanie'],
+            weight: 243,
+        },
+    ],
+    activation: { settingCode: 'linkedin_ads.module_enabled', default: true },
+});
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"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"}

package/dist/migrations/20260727T233211_linkedin_ads_init.d.ts

@@ -0,0 +1,12 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Feature 063 — LinkedIn Ads. Creates `linkedin_conversion_mappings`.
+ *
+ * Channel configuration (enabled, partner id, consent, server-side, access
+ * token) lives in the Settings module and needs no schema here.
+ */
+export declare class Migration20260727T233211LinkedinAdsInit extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260727T233211_linkedin_ads_init.d.ts.map

package/dist/migrations/20260727T233211_linkedin_ads_init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260727T233211_linkedin_ads_init.d.ts","sourceRoot":"","sources":["../../src/migrations/20260727T233211_linkedin_ads_init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;GAKG;AACH,qBAAa,uCAAwC,SAAQ,SAAS;IACrD,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrC"}

package/dist/migrations/20260727T233211_linkedin_ads_init.js

@@ -0,0 +1,36 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Feature 063 — LinkedIn Ads. Creates `linkedin_conversion_mappings`.
+ *
+ * Channel configuration (enabled, partner id, consent, server-side, access
+ * token) lives in the Settings module and needs no schema here.
+ */
+export class Migration20260727T233211LinkedinAdsInit extends Migration {
+    async up() {
+        this.addSql(`
+      create table "linkedin_conversion_mappings" (
+        "id" uuid not null,
+        "sales_channel_id" uuid null,
+        "trigger_action" varchar(32) not null,
+        "conversion_id" varchar(32) not null,
+        "conversion_rule_urn" varchar(128) null,
+        "enabled" boolean not null default true,
+        "version" int not null default 1,
+        "created_at" timestamptz not null,
+        "updated_at" timestamptz not null,
+        constraint "linkedin_conversion_mappings_pkey" primary key ("id")
+      );
+    `);
+        this.addSql(`
+      alter table "linkedin_conversion_mappings"
+        add constraint "linkedin_conversion_mappings_sales_channel_id_foreign"
+          foreign key ("sales_channel_id") references "sales_channels" ("id")
+          on update cascade on delete cascade;
+    `);
+        this.addSql('create index "linkedin_conversion_mappings_channel_action_idx" on "linkedin_conversion_mappings" ("sales_channel_id", "trigger_action");');
+    }
+    async down() {
+        this.addSql('drop table if exists "linkedin_conversion_mappings" cascade;');
+    }
+}
+//# sourceMappingURL=20260727T233211_linkedin_ads_init.js.map

package/dist/migrations/20260727T233211_linkedin_ads_init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260727T233211_linkedin_ads_init.js","sourceRoot":"","sources":["../../src/migrations/20260727T233211_linkedin_ads_init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,OAAO,uCAAwC,SAAQ,SAAS;IAC3D,KAAK,CAAC,EAAE;QACf,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;;;;KAaX,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC;;;;;KAKX,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CACT,0IAA0I,CAC3I,CAAC;IACJ,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CAAC,8DAA8D,CAAC,CAAC;IAC9E,CAAC;CACF"}

package/dist/migrations/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The `./migrations` subpath — every migration class this module owns, as one
+ * ordered `migrations` array.
+ *
+ * The array is what the platform reads when this module is **installed**:
+ * `src/packages/package-runtime.ts` takes `exported['migrations']` and refuses
+ * the package outright when it is absent (D-168).
+ *
+ * Listed in ascending timestamp, which is the order of this module's own
+ * migrations and of nothing else (feature 081): a manifest `dependencies` array
+ * is the only thing ordering this block against another module's.
+ *
+ * The **named** exports stay beside the array, and the asymmetry with
+ * `./backend` — which publishes an array and no named class (D-168) — is
+ * deliberate. `db/migrations-registry.generated.ts` imports each class by name
+ * from this specifier, and a migration class name is contract in a way an entity
+ * class name is not: `mikro_orm_migrations` persists it, so it is a string every
+ * already-migrated database holds.
+ *
+ * A class that is in neither the array nor the barrel is a migration that does
+ * not run: `migration:pending` reports nothing pending and the first symptom is
+ * a query against a table nobody created.
+ */
+import { Migration20260727T233211LinkedinAdsInit } from './20260727T233211_linkedin_ads_init.js';
+export declare const migrations: (typeof Migration20260727T233211LinkedinAdsInit)[];
+export { Migration20260727T233211LinkedinAdsInit, };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,uCAAuC,EAAE,MAAM,wCAAwC,CAAC;AAEjG,eAAO,MAAM,UAAU,oDAEtB,CAAC;AAEF,OAAO,EACL,uCAAuC,GACxC,CAAC"}

package/dist/migrations/index.js

@@ -0,0 +1,29 @@
+/**
+ * The `./migrations` subpath — every migration class this module owns, as one
+ * ordered `migrations` array.
+ *
+ * The array is what the platform reads when this module is **installed**:
+ * `src/packages/package-runtime.ts` takes `exported['migrations']` and refuses
+ * the package outright when it is absent (D-168).
+ *
+ * Listed in ascending timestamp, which is the order of this module's own
+ * migrations and of nothing else (feature 081): a manifest `dependencies` array
+ * is the only thing ordering this block against another module's.
+ *
+ * The **named** exports stay beside the array, and the asymmetry with
+ * `./backend` — which publishes an array and no named class (D-168) — is
+ * deliberate. `db/migrations-registry.generated.ts` imports each class by name
+ * from this specifier, and a migration class name is contract in a way an entity
+ * class name is not: `mikro_orm_migrations` persists it, so it is a string every
+ * already-migrated database holds.
+ *
+ * A class that is in neither the array nor the barrel is a migration that does
+ * not run: `migration:pending` reports nothing pending and the first symptom is
+ * a query against a table nobody created.
+ */
+import { Migration20260727T233211LinkedinAdsInit } from './20260727T233211_linkedin_ads_init.js';
+export const migrations = [
+    Migration20260727T233211LinkedinAdsInit,
+];
+export { Migration20260727T233211LinkedinAdsInit, };
+//# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,uCAAuC,EAAE,MAAM,wCAAwC,CAAC;AAEjG,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,uCAAuC;CACxC,CAAC;AAEF,OAAO,EACL,uCAAuC,GACxC,CAAC"}

package/docs/linkedin-ads.md

@@ -0,0 +1,73 @@
+---
+title: LinkedIn Ads
+description: LinkedIn Insight Tag per sales channel, reporting storefront actions against Campaign Manager conversion rules
+---
+
+# LinkedIn Ads
+
+Puts the **LinkedIn Insight Tag** on the storefront per sales channel and reports storefront
+actions against conversion rules defined in LinkedIn Campaign Manager.
+
+Module id `linkedin_ads`.
+
+## Configuration (Settings module)
+
+All values live in the **LinkedIn Ads** settings group and are overridable per sales channel.
+
+| Setting | Type | Default | Meaning |
+| --- | --- | --- | --- |
+| `linkedin_ads.enabled` | boolean | `false` | Master switch for the channel. |
+| `linkedin_ads.partner_id` | string | `''` | Insight Tag Partner ID from Campaign Manager. |
+| `linkedin_ads.require_consent` | boolean | `true` | Gate all LinkedIn behaviour on the cookie-banner decision. |
+| `linkedin_ads.server_side_enabled` | boolean | `false` | Reserved for Conversions API reporting (not yet implemented). |
+| `linkedin_ads.access_token` | secret | `''` | Conversions API token. Encrypted at rest, write-only — it is never returned by any API. |
+
+A channel is tracked only when the master switch is on **and** the Partner ID is non-blank. A blank
+Partner ID is treated as "not configured", never as an error the visitor can see, so clearing the
+field is a safe way to switch a channel off.
+
+## Storefront behaviour
+
+The Insight Tag is injected client-side, after interaction, so it never blocks the first paint.
+Nothing LinkedIn-related runs — no script, no cookie, no request — until the visitor accepts the
+cookie banner, unless the operator has turned the consent requirement off for that channel. A
+visitor who accepts mid-session is tracked from that moment without a page reload.
+
+Consent is the storefront's single decision, shared with Google Analytics, so there is only ever
+one banner and one stored answer.
+
+## Conversion mappings
+
+Define your conversions in Campaign Manager first; each gets a numeric conversion ID. Then map
+storefront actions to those IDs under **Admin → LinkedIn Ads**.
+
+Supported actions: product viewed, added to cart, added to quote request, added to shopping list,
+checkout started, Place Order clicked, order completed, contact form submitted. The list is exactly
+what the storefront emits — you cannot map an action that could never fire.
+
+A mapping can target one sales channel or all of them, and can be disabled without deleting it. An
+action with no enabled mapping simply reports nothing — that is a normal state, not a
+misconfiguration. One action may map to several conversion IDs; each reports once.
+
+Mappings are served to the storefront through a cached per-channel config; creating, editing, or
+deleting one revalidates that cache immediately rather than waiting for the TTL.
+
+## Permissions
+
+| Code | Grants |
+| --- | --- |
+| `linkedin_ads:read` | View conversion mappings and the module page. |
+| `linkedin_ads:write` | Create, edit, and delete conversion mappings. |
+
+Both appear on `/admin-roles`. Mapping changes are audited with the acting operator.
+
+Conversions are reported from the browser via `lintrk`, and only when the visitor has consented.
+An action mapped more than once reports once per mapping.
+
+## Not yet implemented
+
+- **Server-side reporting through the Conversions API.** Specified and settings-ready, so enabling
+  it later needs no contract change; `linkedin_ads.server_side_enabled` stays off. When it is
+  turned on, the browser path for mapped conversions is suppressed so each conversion has exactly
+  one transport.
+- **Conversion retraction** for refunded or cancelled orders.

package/i18n/en.json

@@ -0,0 +1,35 @@
+{
+  "actions.openLinkedInAds.label": "LinkedIn Ads",
+  "actions.openLinkedInAds.description": "Configure LinkedIn conversion mappings",
+  "actions.newConversionMapping.label": "New LinkedIn conversion mapping",
+  "actions.newConversionMapping.description": "Map a storefront action to a LinkedIn conversion",
+  "nav.linkedInAds.label": "LinkedIn Ads",
+  "mappings.title": "Conversion mappings",
+  "mappings.subtitle": "Report storefront actions against conversion rules defined in LinkedIn Campaign Manager.",
+  "mappings.empty": "No conversion mappings yet",
+  "mappings.new": "New mapping",
+  "mappings.edit": "Edit mapping",
+  "mappings.triggerAction": "Storefront action",
+  "mappings.conversionId": "Conversion ID",
+  "mappings.conversionIdHint": "The numeric ID shown next to the conversion in Campaign Manager.",
+  "mappings.conversionRuleUrn": "Conversion rule URN",
+  "mappings.conversionRuleUrnHint": "Only needed for server-side reporting, and only when it differs from the derived value.",
+  "mappings.salesChannel": "Sales channel",
+  "mappings.allChannels": "All channels",
+  "mappings.enabled": "Enabled",
+  "mappings.save": "Save",
+  "mappings.delete": "Delete",
+  "mappings.deleteConfirm": "Delete this conversion mapping?",
+  "error.generic": "Something went wrong.",
+  "error.notFound": "Conversion mapping not found.",
+  "error.versionConflict": "Someone else changed this mapping. Reload and reapply your edit.",
+  "error.validationFailed": "Some fields are invalid.",
+  "mappings.action.product_viewed": "Product viewed",
+  "mappings.action.add_to_cart": "Added to cart",
+  "mappings.action.add_to_quote_request": "Added to quote request",
+  "mappings.action.add_to_shopping_list": "Added to shopping list",
+  "mappings.action.begin_checkout": "Checkout started",
+  "mappings.action.place_order_clicked": "Place Order clicked",
+  "mappings.action.purchase": "Order completed",
+  "mappings.action.contact_form_submitted": "Contact form submitted"
+}

package/i18n/pl.json

@@ -0,0 +1,35 @@
+{
+  "actions.openLinkedInAds.label": "LinkedIn Ads",
+  "actions.openLinkedInAds.description": "Konfiguruj mapowania konwersji LinkedIn",
+  "actions.newConversionMapping.label": "Nowe mapowanie konwersji LinkedIn",
+  "actions.newConversionMapping.description": "Przypisz akcję w Storefront do konwersji LinkedIn",
+  "nav.linkedInAds.label": "LinkedIn Ads",
+  "mappings.title": "Mapowania konwersji",
+  "mappings.subtitle": "Raportuj akcje w Storefront do reguł konwersji zdefiniowanych w LinkedIn Campaign Manager.",
+  "mappings.empty": "Brak mapowań konwersji",
+  "mappings.new": "Nowe mapowanie",
+  "mappings.edit": "Edytuj mapowanie",
+  "mappings.triggerAction": "Akcja w Storefront",
+  "mappings.conversionId": "ID konwersji",
+  "mappings.conversionIdHint": "Numeryczne ID widoczne przy konwersji w Campaign Manager.",
+  "mappings.conversionRuleUrn": "URN reguły konwersji",
+  "mappings.conversionRuleUrnHint": "Potrzebne tylko przy raportowaniu server-side i tylko gdy różni się od wartości wyliczonej.",
+  "mappings.salesChannel": "Kanał sprzedaży",
+  "mappings.allChannels": "Wszystkie kanały",
+  "mappings.enabled": "Aktywne",
+  "mappings.save": "Zapisz",
+  "mappings.delete": "Usuń",
+  "mappings.deleteConfirm": "Usunąć to mapowanie konwersji?",
+  "error.generic": "Coś poszło nie tak.",
+  "error.notFound": "Nie znaleziono mapowania konwersji.",
+  "error.versionConflict": "Ktoś inny zmienił to mapowanie. Odśwież stronę i ponów zmianę.",
+  "error.validationFailed": "Niektóre pola są nieprawidłowe.",
+  "mappings.action.product_viewed": "Wyświetlenie produktu",
+  "mappings.action.add_to_cart": "Dodanie do koszyka",
+  "mappings.action.add_to_quote_request": "Dodanie do zapytania ofertowego",
+  "mappings.action.add_to_shopping_list": "Dodanie do listy zakupowej",
+  "mappings.action.begin_checkout": "Rozpoczęcie zamówienia",
+  "mappings.action.place_order_clicked": "Kliknięcie „Złóż zamówienie”",
+  "mappings.action.purchase": "Złożenie zamówienia",
+  "mappings.action.contact_form_submitted": "Zapis formularza kontaktowego"
+}