@onlistify/storefront 0.1.0 → 0.1.1

package/dist/node.js

@@ -0,0 +1,125 @@
+import { fileURLToPath } from 'url';
+import path from 'path';
+import fs from 'fs';
+
+// src/sdk/node-api.ts
+
+// ../shared/site-contract/src/index.ts
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function normalizeBlock(block) {
+  if (!isRecord(block)) {
+    return { id: "", type: "", props: {} };
+  }
+  return {
+    id: typeof block.id === "string" ? block.id : "",
+    type: typeof block.type === "string" ? block.type : "",
+    props: isRecord(block.props) ? block.props : {}
+  };
+}
+function normalizePage(page) {
+  if (!isRecord(page)) {
+    return { id: "", path: "/", blocks: [] };
+  }
+  return {
+    id: typeof page.id === "string" ? page.id : "",
+    path: typeof page.path === "string" ? page.path : "/",
+    blocks: Array.isArray(page.blocks) ? page.blocks.map((block) => normalizeBlock(block)) : []
+  };
+}
+function extractSiteObject(raw) {
+  if (!isRecord(raw)) {
+    return raw;
+  }
+  if (raw.data !== void 0) {
+    return extractSiteObject(raw.data);
+  }
+  return raw;
+}
+function normalizeSiteConfig(raw) {
+  const source = extractSiteObject(raw);
+  if (!isRecord(source)) {
+    return { version: 1, pages: [] };
+  }
+  const pages = Array.isArray(source.pages) ? source.pages.map((page) => normalizePage(page)) : [];
+  return {
+    version: typeof source.version === "number" ? source.version : 1,
+    theme: isRecord(source.theme) ? source.theme : void 0,
+    themeOverrides: isRecord(source.themeOverrides) ? source.themeOverrides : void 0,
+    pages
+  };
+}
+
+// src/sdk/node-api.ts
+var BASE_PATH = "/api/v1/public";
+function getModuleDir() {
+  return path.dirname(fileURLToPath(import.meta.url));
+}
+async function pullSiteConfig(options, environment = "draft") {
+  const base = options.apiUrl.replace(/\/$/, "");
+  const url = `${base}${BASE_PATH}/site-config?environment=${environment}`;
+  const res = await fetch(url, { headers: { "X-API-Key": options.apiKey } });
+  if (!res.ok) throw new Error(`pullSiteConfig: ${res.status} ${await res.text()}`);
+  const data = await res.json();
+  const raw = data?.data ?? data ?? { pages: [] };
+  return normalizeSiteConfig(raw);
+}
+async function pushSiteConfig(options, config) {
+  const base = options.apiUrl.replace(/\/$/, "");
+  const url = `${base}${BASE_PATH}/site-config?environment=draft`;
+  const res = await fetch(url, {
+    method: "PUT",
+    headers: { "X-API-Key": options.apiKey, "Content-Type": "application/json" },
+    body: JSON.stringify(config)
+  });
+  if (!res.ok) throw new Error(`pushSiteConfig: ${res.status} ${await res.text()}`);
+}
+async function promoteSiteConfig(options) {
+  const base = options.apiUrl.replace(/\/$/, "");
+  const url = `${base}${BASE_PATH}/site-config/promote`;
+  const res = await fetch(url, { method: "POST", headers: { "X-API-Key": options.apiKey } });
+  if (!res.ok) throw new Error(`promoteSiteConfig: ${res.status} ${await res.text()}`);
+}
+async function triggerWebhook(webhookUrl, payload) {
+  const url = webhookUrl.trim();
+  if (!url) return;
+  await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(payload ?? { event: "onlistify.update" })
+  });
+}
+var DEFAULT_PLUGIN_TYPES = ["onl-hero", "onl-header"];
+function getDefaultPluginsDir() {
+  return path.join(getModuleDir(), "..", "plugins");
+}
+function getDefaultPluginTypes() {
+  return DEFAULT_PLUGIN_TYPES;
+}
+async function exportSiteProject(options, exportOptions) {
+  const config = await pullSiteConfig(options, exportOptions.environment ?? "draft");
+  const outDir = path.resolve(process.cwd(), exportOptions.outputDir);
+  fs.mkdirSync(outDir, { recursive: true });
+  const configPath = path.join(outDir, "site-config.draft.json");
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2), "utf8");
+  let pluginsPath;
+  if (exportOptions.includePlugins !== false) {
+    const pluginsDir = path.join(outDir, "plugins");
+    fs.mkdirSync(pluginsDir, { recursive: true });
+    const sdkPluginsDir = getDefaultPluginsDir();
+    if (fs.existsSync(sdkPluginsDir)) {
+      const files = fs.readdirSync(sdkPluginsDir);
+      for (const f of files) {
+        const src = path.join(sdkPluginsDir, f);
+        if (fs.statSync(src).isFile()) fs.copyFileSync(src, path.join(pluginsDir, f));
+      }
+      pluginsPath = pluginsDir;
+    }
+  }
+  return { configPath, pluginsPath };
+}
+
+export { exportSiteProject, getDefaultPluginTypes, getDefaultPluginsDir, promoteSiteConfig, pullSiteConfig, pushSiteConfig, triggerWebhook };
+//# sourceMappingURL=node.js.map
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../shared/site-contract/src/index.ts","../src/sdk/node-api.ts"],"names":[],"mappings":"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","file":"node.js","sourcesContent":["export type SiteEnvironment = 'draft' | 'live';\n\nexport interface SiteConfigTheme {\n  primaryColor?: string;\n  accentColor?: string;\n  logoUrl?: string;\n  customCssVars?: Record<string, string>;\n}\n\nexport interface PropiedadCardBlockProps {\n  theme?: {\n    primaryColor?: string;\n    accentColor?: string;\n    badgeBackground?: string;\n    cardBorderRadius?: string;\n    imageAspectRatio?: '16/9' | '4/3' | '1/1';\n  };\n  showFields?: Record<string, boolean>;\n  badges?: {\n    featured?: { enabled: boolean; label?: string };\n    virtualTour?: { enabled: boolean; label?: string };\n    custom?: Array<{ key: string; label: string; when?: string }>;\n  };\n  layout?: 'compact' | 'default' | 'minimal';\n  linkTarget?: '_self' | '_blank';\n  openDetailIn?: 'same' | 'modal' | 'drawer';\n}\n\nexport interface BlockDef<TProps = Record<string, unknown>> {\n  id: string;\n  type: string;\n  props?: TProps;\n}\n\nexport interface PageDef {\n  id: string;\n  path: string;\n  blocks: BlockDef[];\n}\n\nexport interface SiteConfig {\n  version?: number;\n  theme?: SiteConfigTheme;\n  themeOverrides?: Record<string, unknown>;\n  pages?: PageDef[];\n}\n\nexport interface ResolvedSiteTheme {\n  primaryColor: string;\n  accentColor: string;\n  logoUrl?: string;\n  customCssVars: Record<string, string>;\n}\n\nconst DEFAULT_SITE_THEME: ResolvedSiteTheme = {\n  primaryColor: '#1a365d',\n  accentColor: '#2b6cb0',\n  customCssVars: {},\n};\n\nconst DEFAULT_HERO_BLOCK: BlockDef = {\n  id: 'hero-1',\n  type: 'onl-hero',\n  props: {\n    title: 'Bienvenido a tu inmobiliaria',\n    subtitle: 'Encuentra tu próximo hogar',\n    ctaText: 'Ver propiedades',\n    ctaUrl: '#',\n    backgroundColor: '#1a365d',\n    textColor: '#fff',\n  },\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return !!value && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction normalizeBlock(block: unknown): BlockDef {\n  if (!isRecord(block)) {\n    return { id: '', type: '', props: {} };\n  }\n\n  return {\n    id: typeof block.id === 'string' ? block.id : '',\n    type: typeof block.type === 'string' ? block.type : '',\n    props: isRecord(block.props) ? block.props : {},\n  };\n}\n\nfunction normalizePage(page: unknown): PageDef {\n  if (!isRecord(page)) {\n    return { id: '', path: '/', blocks: [] };\n  }\n\n  return {\n    id: typeof page.id === 'string' ? page.id : '',\n    path: typeof page.path === 'string' ? page.path : '/',\n    blocks: Array.isArray(page.blocks) ? page.blocks.map((block) => normalizeBlock(block)) : [],\n  };\n}\n\nfunction extractSiteObject(raw: unknown): unknown {\n  if (!isRecord(raw)) {\n    return raw;\n  }\n\n  if (raw.data !== undefined) {\n    return extractSiteObject(raw.data);\n  }\n\n  return raw;\n}\n\nexport function normalizeSiteConfig(raw: unknown): SiteConfig {\n  const source = extractSiteObject(raw);\n\n  if (!isRecord(source)) {\n    return { version: 1, pages: [] };\n  }\n\n  const pages = Array.isArray(source.pages) ? source.pages.map((page) => normalizePage(page)) : [];\n\n  return {\n    version: typeof source.version === 'number' ? source.version : 1,\n    theme: isRecord(source.theme) ? (source.theme as SiteConfigTheme) : undefined,\n    themeOverrides: isRecord(source.themeOverrides) ? (source.themeOverrides as Record<string, unknown>) : undefined,\n    pages,\n  };\n}\n\nexport function createDefaultHeroBlock(): BlockDef {\n  return {\n    ...DEFAULT_HERO_BLOCK,\n    props: { ...DEFAULT_HERO_BLOCK.props },\n  };\n}\n\nexport function getPrimaryPage(config: SiteConfig): PageDef | undefined {\n  const pages = config.pages ?? [];\n  return pages.find((page) => page.path === '/' || page.id === 'listado') ?? pages[0];\n}\n\nexport function getPageBlocks(config: SiteConfig): BlockDef[] {\n  return getPrimaryPage(config)?.blocks ?? [];\n}\n\nexport function ensureDefaultHeroInConfig(config: SiteConfig): SiteConfig {\n  const pages = config.pages ?? [];\n\n  if (!pages.length) {\n    return {\n      ...config,\n      version: config.version ?? 1,\n      pages: [{ id: 'listado', path: '/', blocks: [createDefaultHeroBlock()] }],\n    };\n  }\n\n  const first = pages[0];\n  const blocks = first.blocks ?? [];\n\n  if (blocks.some((block) => block.type === 'onl-hero')) {\n    return {\n      ...config,\n      version: config.version ?? 1,\n      pages,\n    };\n  }\n\n  return {\n    ...config,\n    version: config.version ?? 1,\n    pages: [{ ...first, blocks: [createDefaultHeroBlock(), ...blocks] }, ...pages.slice(1)],\n  };\n}\n\nexport function getPropiedadCardProps(config: SiteConfig): PropiedadCardBlockProps {\n  const block = getPageBlocks(config).find((item) => item.type === 'propiedad-card');\n  return (block?.props ?? {}) as PropiedadCardBlockProps;\n}\n\nexport function resolveSiteTheme(config: SiteConfig): ResolvedSiteTheme {\n  const theme = config.theme ?? {};\n  const overrides = (config.themeOverrides ?? {}) as Record<string, string>;\n\n  return {\n    primaryColor: overrides.primaryColor ?? theme.primaryColor ?? DEFAULT_SITE_THEME.primaryColor,\n    accentColor: overrides.accentColor ?? theme.accentColor ?? DEFAULT_SITE_THEME.accentColor,\n    logoUrl: theme.logoUrl,\n    customCssVars: theme.customCssVars ?? {},\n  };\n}\n","/// <reference types=\"node\" />\nimport { fileURLToPath } from 'node:url';\nimport path from 'node:path';\nimport fs from 'node:fs';\nimport { normalizeSiteConfig } from '../../../shared/site-contract/src/index';\nimport type { SiteConfig } from '../../../shared/site-contract/src/index';\n\nconst BASE_PATH = '/api/v1/public';\n\nexport interface NodeApiOptions {\n  apiUrl: string;\n  apiKey: string;\n}\n\nfunction getModuleDir(): string {\n  return path.dirname(fileURLToPath(import.meta.url));\n}\n\nexport async function pullSiteConfig(options: NodeApiOptions, environment: 'draft' | 'live' = 'draft'): Promise<SiteConfig> {\n  const base = options.apiUrl.replace(/\\/$/, '');\n  const url = `${base}${BASE_PATH}/site-config?environment=${environment}`;\n  const res = await fetch(url, { headers: { 'X-API-Key': options.apiKey } });\n  if (!res.ok) throw new Error(`pullSiteConfig: ${res.status} ${await res.text()}`);\n  const data = await res.json();\n  const raw = data?.data ?? data ?? { pages: [] };\n  return normalizeSiteConfig(raw);\n}\n\nexport async function pushSiteConfig(options: NodeApiOptions, config: SiteConfig): Promise<void> {\n  const base = options.apiUrl.replace(/\\/$/, '');\n  const url = `${base}${BASE_PATH}/site-config?environment=draft`;\n  const res = await fetch(url, {\n    method: 'PUT',\n    headers: { 'X-API-Key': options.apiKey, 'Content-Type': 'application/json' },\n    body: JSON.stringify(config),\n  });\n  if (!res.ok) throw new Error(`pushSiteConfig: ${res.status} ${await res.text()}`);\n}\n\nexport async function promoteSiteConfig(options: NodeApiOptions): Promise<void> {\n  const base = options.apiUrl.replace(/\\/$/, '');\n  const url = `${base}${BASE_PATH}/site-config/promote`;\n  const res = await fetch(url, { method: 'POST', headers: { 'X-API-Key': options.apiKey } });\n  if (!res.ok) throw new Error(`promoteSiteConfig: ${res.status} ${await res.text()}`);\n}\n\nexport async function triggerWebhook(webhookUrl: string, payload?: { event: string; [k: string]: unknown }): Promise<void> {\n  const url = webhookUrl.trim();\n  if (!url) return;\n  await fetch(url, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify(payload ?? { event: 'onlistify.update' }),\n  });\n}\n\nconst DEFAULT_PLUGIN_TYPES = ['onl-hero', 'onl-header'] as const;\n\nexport function getDefaultPluginsDir(): string {\n  return path.join(getModuleDir(), '..', 'plugins');\n}\n\nexport function getDefaultPluginTypes(): readonly string[] {\n  return DEFAULT_PLUGIN_TYPES;\n}\n\nexport interface ExportSiteProjectOptions {\n  outputDir: string;\n  environment?: 'draft' | 'live';\n  includePlugins?: boolean;\n}\n\nexport async function exportSiteProject(\n  options: NodeApiOptions,\n  exportOptions: ExportSiteProjectOptions\n): Promise<{ configPath: string; pluginsPath?: string }> {\n  const config = await pullSiteConfig(options, exportOptions.environment ?? 'draft');\n  const outDir = path.resolve(process.cwd(), exportOptions.outputDir);\n  fs.mkdirSync(outDir, { recursive: true });\n  const configPath = path.join(outDir, 'site-config.draft.json');\n  fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf8');\n\n  let pluginsPath: string | undefined;\n  if (exportOptions.includePlugins !== false) {\n    const pluginsDir = path.join(outDir, 'plugins');\n    fs.mkdirSync(pluginsDir, { recursive: true });\n    const sdkPluginsDir = getDefaultPluginsDir();\n    if (fs.existsSync(sdkPluginsDir)) {\n      const files = fs.readdirSync(sdkPluginsDir);\n      for (const f of files) {\n        const src = path.join(sdkPluginsDir, f);\n        if (fs.statSync(src).isFile()) fs.copyFileSync(src, path.join(pluginsDir, f));\n      }\n      pluginsPath = pluginsDir;\n    }\n  }\n  return { configPath, pluginsPath };\n}\n"]}

package/dist/plugins/README.txt

@@ -0,0 +1,24 @@
+Plugin de ejemplo: Hero (onl-hero)
+
+Archivos:
+- hero-plugin.js: define el custom element <onl-hero>
+- hero-plugin.css: estilos del hero
+- hero-plugin.schema.json: JSON Schema para validación y formularios en el editor
+
+Contrato de bloque (estándar ONlistify):
+- Tipo: identificador con guión (tag del custom element), ej. onl-hero.
+- Props: el host inyecta data-props (JSON) o propiedad .props. El bloque lee y renderiza en connectedCallback.
+- Entrada: el storefront hace createElement(block.type), asigna props, appendChild. Sin asumir framework; debe exponer custom element con ese tag.
+
+Schema de bloque:
+- Un schema.json por plugin con type "object", "title", "properties" (cada una con type, title, default). El editor puede usarlo para generar formularios. Ver hero-plugin.schema.json.
+
+Políticas:
+- Solo se cargan scripts desde URLs del registro de plugins (o PLUGIN_URLS por defecto). CSP del storefront debe incluir esos orígenes en script-src.
+- Límites: bloques por página y tamaño de config validables en backend.
+
+Crear otro plugin:
+1. JS con customElements.define('mi-tag', MiClase); leer props de data-props o .props.
+2. Opcional: schema.json y styles.css.
+3. Registrar en PLUGIN_URLS (storefront) o vía API tenant_plugins.
+4. En config del sitio: block con type: 'mi-tag' y props: { ... }.

package/dist/plugins/header-plugin.css

@@ -0,0 +1,58 @@
+.onl-header {
+  background: var(--onl-header-bg, #1a365d);
+  color: var(--onl-header-color, #fff);
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.12);
+}
+.onl-header--sticky {
+  position: sticky;
+  top: 0;
+  z-index: 100;
+}
+.onl-header-inner {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1.5rem;
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 0.75rem 1.5rem;
+  flex-wrap: wrap;
+}
+.onl-header-brand {
+  display: flex;
+  align-items: center;
+  color: inherit;
+  text-decoration: none;
+  font-weight: 700;
+}
+.onl-header-brand:hover {
+  opacity: 0.9;
+}
+.onl-header-logo {
+  height: 2rem;
+  width: auto;
+  max-width: 160px;
+  object-fit: contain;
+}
+.onl-header-site-name {
+  font-size: 1.25rem;
+  letter-spacing: -0.02em;
+}
+.onl-header-nav {
+  display: flex;
+  align-items: center;
+  gap: 0.25rem 1.25rem;
+  flex-wrap: wrap;
+}
+.onl-header-link {
+  color: inherit;
+  text-decoration: none;
+  font-size: 0.9375rem;
+  font-weight: 500;
+  padding: 0.5rem 0.75rem;
+  border-radius: 6px;
+  transition: background 0.15s;
+}
+.onl-header-link:hover {
+  background: rgba(255, 255, 255, 0.15);
+}

package/dist/plugins/header-plugin.js

@@ -0,0 +1,72 @@
+(function () {
+  const tag = 'onl-header';
+  if (customElements.get(tag)) return;
+
+  class OnlHeader extends HTMLElement {
+    static get observedAttributes() { return ['data-props']; }
+
+    get props() {
+      try {
+        const raw = this.getAttribute('data-props') || this._propsJson || '{}';
+        return typeof raw === 'string' ? JSON.parse(raw) : raw;
+      } catch {
+        return {};
+      }
+    }
+    set props(v) {
+      this._propsJson = v;
+      this.setAttribute('data-props', JSON.stringify(v || {}));
+    }
+
+    connectedCallback() {
+      const p = this.props;
+      const logoUrl = p.logoUrl || '';
+      const siteName = p.siteName || 'Inmobiliaria';
+      const navLinks = Array.isArray(p.navLinks) ? p.navLinks : [];
+      const bgColor = p.backgroundColor || 'var(--storefront-primary, #1a365d)';
+      const textColor = p.textColor || '#fff';
+      const sticky = p.sticky !== false;
+
+      const logoHtml = logoUrl
+        ? `<img src="${escapeAttr(logoUrl)}" alt="${escapeAttr(siteName)}" class="onl-header-logo" />`
+        : `<span class="onl-header-site-name">${escapeHtml(siteName)}</span>`;
+
+      const navHtml =
+        navLinks.length > 0
+          ? `<nav class="onl-header-nav">${navLinks
+              .map(
+                (link) =>
+                  `<a href="${escapeAttr(link.href || '#')}" class="onl-header-link">${escapeHtml(link.label || '')}</a>`
+              )
+              .join('')}</nav>`
+          : '';
+
+      this.innerHTML = `
+        <header class="onl-header ${sticky ? 'onl-header--sticky' : ''}" style="--onl-header-bg:${escapeCss(bgColor)};--onl-header-color:${escapeCss(textColor)}">
+          <div class="onl-header-inner">
+            <a href="/" class="onl-header-brand">${logoHtml}</a>
+            ${navHtml}
+          </div>
+        </header>
+      `;
+    }
+
+    attributeChangedCallback(name) {
+      if (name === 'data-props' && this.isConnected) this.connectedCallback();
+    }
+  }
+
+  function escapeHtml(s) {
+    const div = document.createElement('div');
+    div.textContent = s;
+    return div.innerHTML;
+  }
+  function escapeAttr(s) {
+    return String(s).replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+  }
+  function escapeCss(s) {
+    return String(s).replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+  }
+
+  customElements.define(tag, OnlHeader);
+})();

package/dist/plugins/header-plugin.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "Header",
+  "description": "Cabecera del sitio (onl-header). Logo, nombre y enlaces de navegación.",
+  "properties": {
+    "logoUrl": {
+      "type": "string",
+      "title": "URL del logo",
+      "default": ""
+    },
+    "siteName": {
+      "type": "string",
+      "title": "Nombre del sitio",
+      "default": "Inmobiliaria"
+    },
+    "navLinks": {
+      "type": "array",
+      "title": "Enlaces de navegación",
+      "items": {
+        "type": "object",
+        "properties": {
+          "label": { "type": "string", "title": "Texto" },
+          "href": { "type": "string", "title": "URL", "default": "#" }
+        }
+      },
+      "default": []
+    },
+    "backgroundColor": {
+      "type": "string",
+      "title": "Color de fondo",
+      "default": "#1a365d"
+    },
+    "textColor": {
+      "type": "string",
+      "title": "Color del texto",
+      "default": "#fff"
+    },
+    "sticky": {
+      "type": "boolean",
+      "title": "Cabecera fija al hacer scroll",
+      "default": true
+    }
+  }
+}

package/dist/plugins/hero-plugin.css

@@ -0,0 +1,34 @@
+.onl-hero {
+  background: var(--onl-hero-bg, #1a365d);
+  color: var(--onl-hero-color, #fff);
+  padding: 3rem 1.5rem;
+  text-align: center;
+}
+.onl-hero-inner {
+  max-width: 720px;
+  margin: 0 auto;
+}
+.onl-hero-title {
+  margin: 0 0 0.75rem 0;
+  font-size: clamp(1.5rem, 4vw, 2.25rem);
+  font-weight: 700;
+  line-height: 1.2;
+}
+.onl-hero-subtitle {
+  margin: 0 0 1.5rem 0;
+  font-size: 1.125rem;
+  opacity: 0.95;
+}
+.onl-hero-cta {
+  display: inline-block;
+  padding: 0.75rem 1.5rem;
+  background: rgba(255,255,255,0.2);
+  color: inherit;
+  text-decoration: none;
+  border-radius: 8px;
+  font-weight: 600;
+  transition: background 0.2s;
+}
+.onl-hero-cta:hover {
+  background: rgba(255,255,255,0.3);
+}

package/dist/plugins/hero-plugin.js

@@ -0,0 +1,56 @@
+(function () {
+  const tag = 'onl-hero';
+  if (customElements.get(tag)) return;
+
+  class OnlHero extends HTMLElement {
+    static get observedAttributes() { return ['data-props']; }
+
+    get props() {
+      try {
+        const raw = this.getAttribute('data-props') || this._propsJson || '{}';
+        return typeof raw === 'string' ? JSON.parse(raw) : raw;
+      } catch {
+        return {};
+      }
+    }
+    set props(v) {
+      this._propsJson = v;
+      this.setAttribute('data-props', JSON.stringify(v || {}));
+    }
+
+    connectedCallback() {
+      const p = this.props;
+      const title = p.title || 'Bienvenido';
+      const subtitle = p.subtitle || '';
+      const ctaText = p.ctaText || '';
+      const ctaUrl = p.ctaUrl || '#';
+      const bgColor = p.backgroundColor || 'var(--storefront-primary, #1a365d)';
+      const textColor = p.textColor || '#fff';
+
+      this.innerHTML = `
+        <div class="onl-hero" style="--onl-hero-bg:${bgColor};--onl-hero-color:${textColor}">
+          <div class="onl-hero-inner">
+            <h1 class="onl-hero-title">${escapeHtml(title)}</h1>
+            ${subtitle ? `<p class="onl-hero-subtitle">${escapeHtml(subtitle)}</p>` : ''}
+            ${ctaText ? `<a href="${escapeAttr(ctaUrl)}" class="onl-hero-cta">${escapeHtml(ctaText)}</a>` : ''}
+          </div>
+        </div>
+      `;
+    }
+
+    attributeChangedCallback(name) {
+      if (name === 'data-props' && this.isConnected) this.connectedCallback();
+    }
+  }
+
+  function escapeHtml(s) {
+    const div = document.createElement('div');
+    div.textContent = s;
+    return div.innerHTML;
+  }
+  function escapeAttr(s) {
+    return String(s).replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+  }
+
+  customElements.define(tag, OnlHero);
+})();

package/dist/plugins/hero-plugin.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "Hero",
+  "description": "Bloque Hero (onl-hero). Título, subtítulo y CTA.",
+  "properties": {
+    "title": {
+      "type": "string",
+      "title": "Título",
+      "default": "Bienvenido a tu inmobiliaria"
+    },
+    "subtitle": {
+      "type": "string",
+      "title": "Subtítulo",
+      "default": "Encuentra tu próximo hogar"
+    },
+    "ctaText": {
+      "type": "string",
+      "title": "Texto del botón",
+      "default": "Ver propiedades"
+    },
+    "ctaUrl": {
+      "type": "string",
+      "title": "URL del botón",
+      "default": "#"
+    },
+    "backgroundColor": {
+      "type": "string",
+      "title": "Color de fondo",
+      "default": "#1a365d"
+    },
+    "textColor": {
+      "type": "string",
+      "title": "Color del texto",
+      "default": "#fff"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlistify/storefront",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -15,8 +15,21 @@
         "types": "./dist/index.d.cts",
         "default": "./dist/index.cjs"
       }
+    },
+    "./node": {
+      "import": {
+        "types": "./dist/node.d.ts",
+        "default": "./dist/node.js"
+      },
+      "require": {
+        "types": "./dist/node.d.cts",
+        "default": "./dist/node.cjs"
+      }
     }
   },
+  "bin": {
+    "onlistify": "./dist/cli.js"
+  },
   "files": [
     "dist"
   ],
@@ -33,6 +46,7 @@
     "ramda": "^0.29.1"
   },
   "devDependencies": {
+    "@types/node": "^25.5.0",
     "@types/ramda": "^0.31.1",
     "tsup": "^8.5.1",
     "typescript": "~5.6.0",
@@ -41,7 +55,7 @@
   "scripts": {
     "dev": "vite",
     "build": "tsc && vite build",
-    "build:sdk": "tsup",
+    "build:sdk": "tsup && node scripts/copy-plugins-to-dist.js",
     "preview": "vite preview"
   }
 }