@fayz-ai/plugin-marketing 0.1.1 → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Faya Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+# @fayz-ai/plugin-marketing
+
+> One acquisition & conversion engine — every channel, every vertical.
+
+[![npm](https://img.shields.io/npm/v/@fayz-ai/plugin-marketing.svg)](https://www.npmjs.com/package/@fayz-ai/plugin-marketing)
+[![license](https://img.shields.io/npm/l/@fayz-ai/plugin-marketing.svg)](https://github.com/FayaLabs/fayz-sdk/blob/main/LICENSE)
+
+Marketing analytics are always the same shape — channels, campaigns, a funnel, landing-page CVR — but what counts as a "conversion" changes per business. A salon converts a booking, a store converts an order, an agency converts a lead. `plugin-marketing` is one plugin that adapts to all of them: pick a `domain` preset (or pass an explicit conversion model + channels) and the funnel, channel performance, and cost-per-acquisition are computed generically on top of it.
+
+It ships a vertical-flavored mock today so the surface is real from the first install. Real attribution arrives through clean DI seams — an `AttributionBridge` to read conversions from CRM/agenda/orders, and a `SitesPerformanceBridge` to read landing-page numbers from your sites — so you wire reality in without rewriting the plugin. Campaigns and channels are first-class, and the whole thing exposes AI tools so your assistant can answer "which channel converts best?" out loud.
+
+## What's inside
+- A `/marketing` workspace: overview, channels (list + detail), campaigns (list + composer), funnel, and landing pages
+- `domain` presets that set the conversion model + acquisition channels per vertical (defaults to `agency`)
+- Generic channel performance (reach, conversions, CVR, spend, CPA), funnel, and campaign CVR
+- DI seams: `attributionBridge` and `sitesBridge` to feed real data when it's ready
+- Domain events: `marketing.conversion.tracked`, `campaign.created`, `campaign.updated`, `channel.synced`
+- AI tools: `channelPerformance`, `topChannels`, `campaignCvr`, and `createCampaign`
+- Dashboard widgets, a central Settings tab, currency formatting, and full i18n
+- Exported `MARKETING_PRESETS` and a mock provider for local development
+
+## Install
+```bash
+npm install @fayz-ai/plugin-marketing
+```
+Peer deps: `@fayz-ai/core`, `@fayz-ai/ui`, `@fayz-ai/saas`, plus `react` / `react-dom`.
+
+## Usage
+```tsx
+import { defineSaas } from '@fayz-ai/saas'
+import { createMarketingPlugin } from '@fayz-ai/plugin-marketing'
+
+export const app = defineSaas({
+  // ...
+  plugins: [
+    createMarketingPlugin({
+      domain: 'beauty',            // conversion model + channels from the preset
+      currency: { code: 'BRL' },
+      // attributionBridge / sitesBridge wire real data in later
+    }),
+  ],
+})
+```
+
+## Part of the Fayz SDK
+The acquisition half of growth. Pairs with `plugin-crm` (the leads and deals it converts into), `plugin-conversations` (broadcast replies land in the inbox), and `plugin-reputation` (social proof that lifts CVR).
+
+## Roadmap & contributing
+Built and evolving in the open. See the [Fayz SDK roadmap](../../docs/ROADMAP.md#plugin-marketing) for current gaps, missing features, and good first issues.

package/dist/index.cjs

@@ -2,8 +2,8 @@
 
 var React4 = require('react');
 var core = require('@fayz-ai/core');
-var ui = require('@fayz-ai/ui');
 var saas = require('@fayz-ai/saas');
+var ui = require('@fayz-ai/ui');
 var jsxRuntime = require('react/jsx-runtime');
 var lucideReact = require('lucide-react');
 var vanilla = require('zustand/vanilla');
@@ -583,6 +583,42 @@ function SettingsView() {
     ] })
   ] });
 }
+
+// src/registries.ts
+var KIND_OPTIONS = [
+  { value: "paid", label: "Paid" },
+  { value: "organic", label: "Organic" },
+  { value: "social", label: "Social" },
+  { value: "referral", label: "Referral" },
+  { value: "direct", label: "Direct" },
+  { value: "outbound", label: "Outbound" }
+];
+var channelEntity = {
+  name: "Channel",
+  namePlural: "Channels",
+  icon: "Radio",
+  displayField: "label",
+  defaultSort: "label",
+  fields: [
+    { key: "label", label: "Channel", type: "text", required: true, showInTable: true, searchable: true },
+    { key: "kind", label: "Type", type: "select", options: KIND_OPTIONS, showInTable: true },
+    { key: "icon", label: "Icon", type: "text", showInTable: true }
+  ],
+  facets: [{ field: "kind" }]
+};
+function buildMarketingRegistries(channels) {
+  return [
+    {
+      id: "channels",
+      entity: channelEntity,
+      icon: "Radio",
+      description: "Acquisition channels tracked for this workspace",
+      display: "table",
+      readOnly: true,
+      seedData: channels.map((c) => ({ id: c.id, label: c.label, kind: c.kind, icon: c.icon }))
+    }
+  ];
+}
 function useEnsureMarketingData() {
   const overview = useMarketingStore((s) => s.overview);
   const loading = useMarketingStore((s) => s.loading);
@@ -1234,10 +1270,17 @@ function createMarketingPlugin(options) {
     React4__default.default.createElement(MarketingPage, { config, provider, store })
   );
   PageComponent.displayName = "MarketingPage";
+  const marketingRegistries = buildMarketingRegistries(config.channels);
   const SettingsComponent = () => React4__default.default.createElement(
     MarketingContextProvider,
     { config, provider, store },
-    React4__default.default.createElement(SettingsView)
+    React4__default.default.createElement(saas.PluginSettingsPanel, {
+      title: config.labels.settings ?? config.labels.pageTitle,
+      subtitle: config.labels.pageSubtitle,
+      generalSettings: React4__default.default.createElement(SettingsView),
+      registries: marketingRegistries,
+      routeBase: "/settings/marketing"
+    })
   );
   SettingsComponent.displayName = "MarketingSettings";
   return {
@@ -1333,6 +1376,7 @@ function createMarketingPlugin(options) {
         permission: { feature: "marketing", action: "create" }
       }
     ],
+    registries: marketingRegistries,
     settings: [
       {
         id: "marketing",