@suucha/ads-adsense 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Suucha Studio
+
+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,87 @@
+# @suucha/ads-adsense
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../../LICENSE)
+
+Google AdSense ad manager implementation for Suucha Web SDK. Dynamically loads `adsbygoogle.js` and mounts ad slots into DOM containers.
+
+## Install
+
+```bash
+pnpm add @suucha/core @suucha/ads-adsense
+```
+
+## Usage
+
+### Auto Ads (simplest)
+
+```typescript
+import { suucha } from '@suucha/core';
+import { AdSenseManager } from '@suucha/ads-adsense';
+
+const ads = new AdSenseManager({
+  client: 'ca-pub-1234567890123456',
+  autoAds: true,
+});
+
+suucha.enableAds(ads);
+// AdSense automatically picks ad placements
+```
+
+### Manual Slots
+
+```typescript
+const ads = new AdSenseManager({
+  client: 'ca-pub-1234567890123456',
+});
+
+suucha.enableAds(ads);
+
+const handle = await ads.mountSlot({
+  container: '#ad-banner',  // CSS selector or HTMLElement
+  slot: '1234567890',
+  format: 'horizontal',
+});
+
+// Refresh slot
+handle.refresh();
+
+// Tear down
+ads.unmountSlot(handle);
+```
+
+## Consent / GDPR
+
+```typescript
+const ads = new AdSenseManager({
+  client: 'ca-pub-...',
+  deferUntilConsent: true,
+});
+
+// Script not loaded yet
+suucha.enableAds(ads);
+
+// After CMP grants consent:
+suucha.setConsent(true);
+ads.load();
+```
+
+## Options
+
+| Option | Default | Description |
+|---|---|---|
+| `client` | (required) | Publisher ID (`ca-pub-XXXX`) |
+| `autoAds` | `false` | Enable AdSense auto-ad placement |
+| `deferUntilConsent` | `false` | Skip script load until `load()` called |
+
+## Slot Options
+
+| Option | Default | Description |
+|---|---|---|
+| `container` | (required) | CSS selector or HTMLElement |
+| `slot` | - | Ad unit ID |
+| `format` | `'auto'` | `'auto'` / `'horizontal'` / `'vertical'` / `'rectangle'` |
+| `responsive` | `true` | Fill container width |
+
+## License
+
+MIT © Suucha Studio

package/dist/index.cjs

@@ -0,0 +1,119 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/index.ts
+var DEFAULT_SCRIPT_SRC = "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js";
+var nextSlotId = 1;
+var AdSenseManager = class {
+  constructor(options) {
+    __publicField(this, "options");
+    __publicField(this, "loaded", false);
+    __publicField(this, "slots", /* @__PURE__ */ new Map());
+    if (!options.client || !options.client.startsWith("ca-pub-")) {
+      throw new Error(
+        `[AdSenseManager] client must start with 'ca-pub-', got: ${options.client}`
+      );
+    }
+    this.options = {
+      autoAds: false,
+      deferUntilConsent: false,
+      scriptSrc: DEFAULT_SCRIPT_SRC,
+      ...options
+    };
+    if (!this.options.deferUntilConsent) {
+      this.load();
+    }
+    if (this.options.autoAds) {
+      this.enableAutoAds();
+    }
+  }
+  /**
+   * 加载 AdSense 脚本
+   */
+  load() {
+    if (this.loaded) return;
+    if (typeof document === "undefined") return;
+    const script = document.createElement("script");
+    script.async = true;
+    script.src = `${this.options.scriptSrc}?client=${this.options.client}`;
+    script.crossOrigin = "anonymous";
+    document.head.appendChild(script);
+    window.adsbygoogle = window.adsbygoogle || [];
+    this.loaded = true;
+  }
+  /**
+   * 启用自动广告（AdSense 自动选择位置）
+   */
+  enableAutoAds() {
+    if (typeof window === "undefined" || !window.adsbygoogle) return;
+    window.adsbygoogle.push({ google_ad_client: this.options.client });
+  }
+  /**
+   * 挂载广告位到 DOM
+   */
+  async mountSlot(slotOptions) {
+    if (typeof document === "undefined") {
+      throw new Error("[AdSenseManager] mountSlot requires a browser environment");
+    }
+    const container = typeof slotOptions.container === "string" ? document.querySelector(slotOptions.container) : slotOptions.container;
+    if (!container) {
+      throw new Error(
+        `[AdSenseManager] Container not found: ${slotOptions.container}`
+      );
+    }
+    const ins = document.createElement("ins");
+    ins.className = "adsbygoogle";
+    ins.style.display = "block";
+    ins.setAttribute("data-ad-client", this.options.client);
+    if (slotOptions.slot) {
+      ins.setAttribute("data-ad-slot", slotOptions.slot);
+    }
+    ins.setAttribute(
+      "data-ad-format",
+      slotOptions.format ?? "auto"
+    );
+    if (slotOptions.responsive !== false) {
+      ins.setAttribute("data-full-width-responsive", "true");
+    }
+    container.appendChild(ins);
+    if (window.adsbygoogle) {
+      window.adsbygoogle.push({});
+    }
+    const id = `adsense_slot_${nextSlotId++}`;
+    const handle = {
+      id,
+      slot: slotOptions.slot ?? "",
+      refresh: () => {
+        if (window.adsbygoogle) {
+          window.adsbygoogle.push({ refresh: () => {
+          } });
+        }
+      },
+      destroy: () => {
+        ins.remove();
+        this.slots.delete(id);
+      }
+    };
+    this.slots.set(id, handle);
+    return handle;
+  }
+  /**
+   * 卸载广告位
+   */
+  unmountSlot(handle) {
+    handle.destroy();
+  }
+  /**
+   * 刷新广告位（重新竞价）
+   */
+  refresh(handle) {
+    handle.refresh();
+  }
+};
+
+exports.AdSenseManager = AdSenseManager;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\r\n * @suucha/ads-adsense\r\n *\r\n * Google AdSense 广告管理实现。\r\n * 动态加载 pagead2 脚本，提供 mountSlot / unmountSlot / refresh / enableAutoAds。\r\n */\r\n\r\nimport type { AdSlotHandle, AdSlotOptions, IAdManager } from '@suucha/core';\r\n\r\nexport interface AdSenseOptions {\r\n  /** 发布者 ID，必填，格式 'ca-pub-xxxxxxxxxxxxxxxx' */\r\n  client: string;\r\n  /** 是否启用自动广告，默认 false */\r\n  autoAds?: boolean;\r\n  /** 是否在 consent 未授予时不加载脚本 */\r\n  deferUntilConsent?: boolean;\r\n  /** 自定义脚本来源（用于测试或代理） */\r\n  scriptSrc?: string;\r\n}\r\n\r\nexport interface AdSenseSlotOptions extends AdSlotOptions {\r\n  /** 广告单元 ID（如 '1234567890'） */\r\n  slot?: string;\r\n  /** 广告格式，默认 'auto' */\r\n  format?: 'auto' | 'horizontal' | 'vertical' | 'rectangle';\r\n  /** 是否响应式，默认 true */\r\n  responsive?: boolean;\r\n}\r\n\r\ninterface AdSenseSlotHandleInternal extends AdSlotHandle {\r\n  refresh(): void;\r\n}\r\n\r\ndeclare global {\r\n  interface Window {\r\n    adsbygoogle?: unknown[];\r\n  }\r\n}\r\n\r\nconst DEFAULT_SCRIPT_SRC = 'https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js';\r\n\r\nlet nextSlotId = 1;\r\n\r\nexport class AdSenseManager implements IAdManager {\r\n  private readonly options: Required<AdSenseOptions>;\r\n  private loaded = false;\r\n  private readonly slots = new Map<string, AdSenseSlotHandleInternal>();\r\n\r\n  constructor(options: AdSenseOptions) {\r\n    if (!options.client || !options.client.startsWith('ca-pub-')) {\r\n      throw new Error(\r\n        `[AdSenseManager] client must start with 'ca-pub-', got: ${options.client}`,\r\n      );\r\n    }\r\n    this.options = {\r\n      autoAds: false,\r\n      deferUntilConsent: false,\r\n      scriptSrc: DEFAULT_SCRIPT_SRC,\r\n      ...options,\r\n    };\r\n\r\n    if (!this.options.deferUntilConsent) {\r\n      this.load();\r\n    }\r\n\r\n    if (this.options.autoAds) {\r\n      this.enableAutoAds();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 加载 AdSense 脚本\r\n   */\r\n  load(): void {\r\n    if (this.loaded) return;\r\n    if (typeof document === 'undefined') return;\r\n\r\n    const script = document.createElement('script');\r\n    script.async = true;\r\n    script.src = `${this.options.scriptSrc}?client=${this.options.client}`;\r\n    script.crossOrigin = 'anonymous';\r\n    document.head.appendChild(script);\r\n\r\n    window.adsbygoogle = window.adsbygoogle || [];\r\n    this.loaded = true;\r\n  }\r\n\r\n  /**\r\n   * 启用自动广告（AdSense 自动选择位置）\r\n   */\r\n  enableAutoAds(): void {\r\n    if (typeof window === 'undefined' || !window.adsbygoogle) return;\r\n    window.adsbygoogle.push({ google_ad_client: this.options.client });\r\n  }\r\n\r\n  /**\r\n   * 挂载广告位到 DOM\r\n   */\r\n  async mountSlot(slotOptions: AdSenseSlotOptions): Promise<AdSenseSlotHandleInternal> {\r\n    if (typeof document === 'undefined') {\r\n      throw new Error('[AdSenseManager] mountSlot requires a browser environment');\r\n    }\r\n    const container =\r\n      typeof slotOptions.container === 'string'\r\n        ? document.querySelector<HTMLElement>(slotOptions.container)\r\n        : slotOptions.container;\r\n    if (!container) {\r\n      throw new Error(\r\n        `[AdSenseManager] Container not found: ${slotOptions.container}`,\r\n      );\r\n    }\r\n\r\n    const ins = document.createElement('ins');\r\n    ins.className = 'adsbygoogle';\r\n    ins.style.display = 'block';\r\n    ins.setAttribute('data-ad-client', this.options.client);\r\n    if (slotOptions.slot) {\r\n      ins.setAttribute('data-ad-slot', slotOptions.slot);\r\n    }\r\n    ins.setAttribute(\r\n      'data-ad-format',\r\n      slotOptions.format ?? 'auto',\r\n    );\r\n    if (slotOptions.responsive !== false) {\r\n      ins.setAttribute('data-full-width-responsive', 'true');\r\n    }\r\n    container.appendChild(ins);\r\n\r\n    if (window.adsbygoogle) {\r\n      window.adsbygoogle.push({});\r\n    }\r\n\r\n    const id = `adsense_slot_${nextSlotId++}`;\r\n    const handle: AdSenseSlotHandleInternal = {\r\n      id,\r\n      slot: slotOptions.slot ?? '',\r\n      refresh: () => {\r\n        if (window.adsbygoogle) {\r\n          window.adsbygoogle.push({ refresh: () => {} });\r\n        }\r\n      },\r\n      destroy: () => {\r\n        ins.remove();\r\n        this.slots.delete(id);\r\n      },\r\n    };\r\n    this.slots.set(id, handle);\r\n    return handle;\r\n  }\r\n\r\n  /**\r\n   * 卸载广告位\r\n   */\r\n  unmountSlot(handle: AdSenseSlotHandleInternal): void {\r\n    handle.destroy();\r\n  }\r\n\r\n  /**\r\n   * 刷新广告位（重新竞价）\r\n   */\r\n  refresh(handle: AdSenseSlotHandleInternal): void {\r\n    handle.refresh();\r\n  }\r\n}\r\n\r\nexport type { AdSenseSlotHandleInternal };\r\n"]}

package/dist/index.d.cts

@@ -0,0 +1,63 @@
+import { IAdManager, AdSlotOptions, AdSlotHandle } from '@suucha/core';
+
+/**
+ * @suucha/ads-adsense
+ *
+ * Google AdSense 广告管理实现。
+ * 动态加载 pagead2 脚本，提供 mountSlot / unmountSlot / refresh / enableAutoAds。
+ */
+
+interface AdSenseOptions {
+    /** 发布者 ID，必填，格式 'ca-pub-xxxxxxxxxxxxxxxx' */
+    client: string;
+    /** 是否启用自动广告，默认 false */
+    autoAds?: boolean;
+    /** 是否在 consent 未授予时不加载脚本 */
+    deferUntilConsent?: boolean;
+    /** 自定义脚本来源（用于测试或代理） */
+    scriptSrc?: string;
+}
+interface AdSenseSlotOptions extends AdSlotOptions {
+    /** 广告单元 ID（如 '1234567890'） */
+    slot?: string;
+    /** 广告格式，默认 'auto' */
+    format?: 'auto' | 'horizontal' | 'vertical' | 'rectangle';
+    /** 是否响应式，默认 true */
+    responsive?: boolean;
+}
+interface AdSenseSlotHandleInternal extends AdSlotHandle {
+    refresh(): void;
+}
+declare global {
+    interface Window {
+        adsbygoogle?: unknown[];
+    }
+}
+declare class AdSenseManager implements IAdManager {
+    private readonly options;
+    private loaded;
+    private readonly slots;
+    constructor(options: AdSenseOptions);
+    /**
+     * 加载 AdSense 脚本
+     */
+    load(): void;
+    /**
+     * 启用自动广告（AdSense 自动选择位置）
+     */
+    enableAutoAds(): void;
+    /**
+     * 挂载广告位到 DOM
+     */
+    mountSlot(slotOptions: AdSenseSlotOptions): Promise<AdSenseSlotHandleInternal>;
+    /**
+     * 卸载广告位
+     */
+    unmountSlot(handle: AdSenseSlotHandleInternal): void;
+    /**
+     * 刷新广告位（重新竞价）
+     */
+    refresh(handle: AdSenseSlotHandleInternal): void;
+}
+
+export { AdSenseManager, type AdSenseOptions, type AdSenseSlotHandleInternal, type AdSenseSlotOptions };

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+import { IAdManager, AdSlotOptions, AdSlotHandle } from '@suucha/core';
+
+/**
+ * @suucha/ads-adsense
+ *
+ * Google AdSense 广告管理实现。
+ * 动态加载 pagead2 脚本，提供 mountSlot / unmountSlot / refresh / enableAutoAds。
+ */
+
+interface AdSenseOptions {
+    /** 发布者 ID，必填，格式 'ca-pub-xxxxxxxxxxxxxxxx' */
+    client: string;
+    /** 是否启用自动广告，默认 false */
+    autoAds?: boolean;
+    /** 是否在 consent 未授予时不加载脚本 */
+    deferUntilConsent?: boolean;
+    /** 自定义脚本来源（用于测试或代理） */
+    scriptSrc?: string;
+}
+interface AdSenseSlotOptions extends AdSlotOptions {
+    /** 广告单元 ID（如 '1234567890'） */
+    slot?: string;
+    /** 广告格式，默认 'auto' */
+    format?: 'auto' | 'horizontal' | 'vertical' | 'rectangle';
+    /** 是否响应式，默认 true */
+    responsive?: boolean;
+}
+interface AdSenseSlotHandleInternal extends AdSlotHandle {
+    refresh(): void;
+}
+declare global {
+    interface Window {
+        adsbygoogle?: unknown[];
+    }
+}
+declare class AdSenseManager implements IAdManager {
+    private readonly options;
+    private loaded;
+    private readonly slots;
+    constructor(options: AdSenseOptions);
+    /**
+     * 加载 AdSense 脚本
+     */
+    load(): void;
+    /**
+     * 启用自动广告（AdSense 自动选择位置）
+     */
+    enableAutoAds(): void;
+    /**
+     * 挂载广告位到 DOM
+     */
+    mountSlot(slotOptions: AdSenseSlotOptions): Promise<AdSenseSlotHandleInternal>;
+    /**
+     * 卸载广告位
+     */
+    unmountSlot(handle: AdSenseSlotHandleInternal): void;
+    /**
+     * 刷新广告位（重新竞价）
+     */
+    refresh(handle: AdSenseSlotHandleInternal): void;
+}
+
+export { AdSenseManager, type AdSenseOptions, type AdSenseSlotHandleInternal, type AdSenseSlotOptions };

package/dist/index.js

@@ -0,0 +1,117 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/index.ts
+var DEFAULT_SCRIPT_SRC = "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js";
+var nextSlotId = 1;
+var AdSenseManager = class {
+  constructor(options) {
+    __publicField(this, "options");
+    __publicField(this, "loaded", false);
+    __publicField(this, "slots", /* @__PURE__ */ new Map());
+    if (!options.client || !options.client.startsWith("ca-pub-")) {
+      throw new Error(
+        `[AdSenseManager] client must start with 'ca-pub-', got: ${options.client}`
+      );
+    }
+    this.options = {
+      autoAds: false,
+      deferUntilConsent: false,
+      scriptSrc: DEFAULT_SCRIPT_SRC,
+      ...options
+    };
+    if (!this.options.deferUntilConsent) {
+      this.load();
+    }
+    if (this.options.autoAds) {
+      this.enableAutoAds();
+    }
+  }
+  /**
+   * 加载 AdSense 脚本
+   */
+  load() {
+    if (this.loaded) return;
+    if (typeof document === "undefined") return;
+    const script = document.createElement("script");
+    script.async = true;
+    script.src = `${this.options.scriptSrc}?client=${this.options.client}`;
+    script.crossOrigin = "anonymous";
+    document.head.appendChild(script);
+    window.adsbygoogle = window.adsbygoogle || [];
+    this.loaded = true;
+  }
+  /**
+   * 启用自动广告（AdSense 自动选择位置）
+   */
+  enableAutoAds() {
+    if (typeof window === "undefined" || !window.adsbygoogle) return;
+    window.adsbygoogle.push({ google_ad_client: this.options.client });
+  }
+  /**
+   * 挂载广告位到 DOM
+   */
+  async mountSlot(slotOptions) {
+    if (typeof document === "undefined") {
+      throw new Error("[AdSenseManager] mountSlot requires a browser environment");
+    }
+    const container = typeof slotOptions.container === "string" ? document.querySelector(slotOptions.container) : slotOptions.container;
+    if (!container) {
+      throw new Error(
+        `[AdSenseManager] Container not found: ${slotOptions.container}`
+      );
+    }
+    const ins = document.createElement("ins");
+    ins.className = "adsbygoogle";
+    ins.style.display = "block";
+    ins.setAttribute("data-ad-client", this.options.client);
+    if (slotOptions.slot) {
+      ins.setAttribute("data-ad-slot", slotOptions.slot);
+    }
+    ins.setAttribute(
+      "data-ad-format",
+      slotOptions.format ?? "auto"
+    );
+    if (slotOptions.responsive !== false) {
+      ins.setAttribute("data-full-width-responsive", "true");
+    }
+    container.appendChild(ins);
+    if (window.adsbygoogle) {
+      window.adsbygoogle.push({});
+    }
+    const id = `adsense_slot_${nextSlotId++}`;
+    const handle = {
+      id,
+      slot: slotOptions.slot ?? "",
+      refresh: () => {
+        if (window.adsbygoogle) {
+          window.adsbygoogle.push({ refresh: () => {
+          } });
+        }
+      },
+      destroy: () => {
+        ins.remove();
+        this.slots.delete(id);
+      }
+    };
+    this.slots.set(id, handle);
+    return handle;
+  }
+  /**
+   * 卸载广告位
+   */
+  unmountSlot(handle) {
+    handle.destroy();
+  }
+  /**
+   * 刷新广告位（重新竞价）
+   */
+  refresh(handle) {
+    handle.refresh();
+  }
+};
+
+export { AdSenseManager };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;AAuCA,IAAM,kBAAA,GAAqB,gEAAA;AAE3B,IAAI,UAAA,GAAa,CAAA;AAEV,IAAM,iBAAN,MAA2C;AAAA,EAKhD,YAAY,OAAA,EAAyB;AAJrC,IAAA,aAAA,CAAA,IAAA,EAAiB,SAAA,CAAA;AACjB,IAAA,aAAA,CAAA,IAAA,EAAQ,QAAA,EAAS,KAAA,CAAA;AACjB,IAAA,aAAA,CAAA,IAAA,EAAiB,OAAA,sBAAY,GAAA,EAAuC,CAAA;AAGlE,IAAA,IAAI,CAAC,QAAQ,MAAA,IAAU,CAAC,QAAQ,MAAA,CAAO,UAAA,CAAW,SAAS,CAAA,EAAG;AAC5D,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,wDAAA,EAA2D,QAAQ,MAAM,CAAA;AAAA,OAC3E;AAAA,IACF;AACA,IAAA,IAAA,CAAK,OAAA,GAAU;AAAA,MACb,OAAA,EAAS,KAAA;AAAA,MACT,iBAAA,EAAmB,KAAA;AAAA,MACnB,SAAA,EAAW,kBAAA;AAAA,MACX,GAAG;AAAA,KACL;AAEA,IAAA,IAAI,CAAC,IAAA,CAAK,OAAA,CAAQ,iBAAA,EAAmB;AACnC,MAAA,IAAA,CAAK,IAAA,EAAK;AAAA,IACZ;AAEA,IAAA,IAAI,IAAA,CAAK,QAAQ,OAAA,EAAS;AACxB,MAAA,IAAA,CAAK,aAAA,EAAc;AAAA,IACrB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,IAAA,GAAa;AACX,IAAA,IAAI,KAAK,MAAA,EAAQ;AACjB,IAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AAErC,IAAA,MAAM,MAAA,GAAS,QAAA,CAAS,aAAA,CAAc,QAAQ,CAAA;AAC9C,IAAA,MAAA,CAAO,KAAA,GAAQ,IAAA;AACf,IAAA,MAAA,CAAO,GAAA,GAAM,GAAG,IAAA,CAAK,OAAA,CAAQ,SAAS,CAAA,QAAA,EAAW,IAAA,CAAK,QAAQ,MAAM,CAAA,CAAA;AACpE,IAAA,MAAA,CAAO,WAAA,GAAc,WAAA;AACrB,IAAA,QAAA,CAAS,IAAA,CAAK,YAAY,MAAM,CAAA;AAEhC,IAAA,MAAA,CAAO,WAAA,GAAc,MAAA,CAAO,WAAA,IAAe,EAAC;AAC5C,IAAA,IAAA,CAAK,MAAA,GAAS,IAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,aAAA,GAAsB;AACpB,IAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,CAAC,OAAO,WAAA,EAAa;AAC1D,IAAA,MAAA,CAAO,YAAY,IAAA,CAAK,EAAE,kBAAkB,IAAA,CAAK,OAAA,CAAQ,QAAQ,CAAA;AAAA,EACnE;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,UAAU,WAAA,EAAqE;AACnF,IAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACnC,MAAA,MAAM,IAAI,MAAM,2DAA2D,CAAA;AAAA,IAC7E;AACA,IAAA,MAAM,SAAA,GACJ,OAAO,WAAA,CAAY,SAAA,KAAc,QAAA,GAC7B,SAAS,aAAA,CAA2B,WAAA,CAAY,SAAS,CAAA,GACzD,WAAA,CAAY,SAAA;AAClB,IAAA,IAAI,CAAC,SAAA,EAAW;AACd,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,sCAAA,EAAyC,YAAY,SAAS,CAAA;AAAA,OAChE;AAAA,IACF;AAEA,IAAA,MAAM,GAAA,GAAM,QAAA,CAAS,aAAA,CAAc,KAAK,CAAA;AACxC,IAAA,GAAA,CAAI,SAAA,GAAY,aAAA;AAChB,IAAA,GAAA,CAAI,MAAM,OAAA,GAAU,OAAA;AACpB,IAAA,GAAA,CAAI,YAAA,CAAa,gBAAA,EAAkB,IAAA,CAAK,OAAA,CAAQ,MAAM,CAAA;AACtD,IAAA,IAAI,YAAY,IAAA,EAAM;AACpB,MAAA,GAAA,CAAI,YAAA,CAAa,cAAA,EAAgB,WAAA,CAAY,IAAI,CAAA;AAAA,IACnD;AACA,IAAA,GAAA,CAAI,YAAA;AAAA,MACF,gBAAA;AAAA,MACA,YAAY,MAAA,IAAU;AAAA,KACxB;AACA,IAAA,IAAI,WAAA,CAAY,eAAe,KAAA,EAAO;AACpC,MAAA,GAAA,CAAI,YAAA,CAAa,8BAA8B,MAAM,CAAA;AAAA,IACvD;AACA,IAAA,SAAA,CAAU,YAAY,GAAG,CAAA;AAEzB,IAAA,IAAI,OAAO,WAAA,EAAa;AACtB,MAAA,MAAA,CAAO,WAAA,CAAY,IAAA,CAAK,EAAE,CAAA;AAAA,IAC5B;AAEA,IAAA,MAAM,EAAA,GAAK,gBAAgB,UAAA,EAAY,CAAA,CAAA;AACvC,IAAA,MAAM,MAAA,GAAoC;AAAA,MACxC,EAAA;AAAA,MACA,IAAA,EAAM,YAAY,IAAA,IAAQ,EAAA;AAAA,MAC1B,SAAS,MAAM;AACb,QAAA,IAAI,OAAO,WAAA,EAAa;AACtB,UAAA,MAAA,CAAO,WAAA,CAAY,IAAA,CAAK,EAAE,OAAA,EAAS,MAAM;AAAA,UAAC,GAAG,CAAA;AAAA,QAC/C;AAAA,MACF,CAAA;AAAA,MACA,SAAS,MAAM;AACb,QAAA,GAAA,CAAI,MAAA,EAAO;AACX,QAAA,IAAA,CAAK,KAAA,CAAM,OAAO,EAAE,CAAA;AAAA,MACtB;AAAA,KACF;AACA,IAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,EAAA,EAAI,MAAM,CAAA;AACzB,IAAA,OAAO,MAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,YAAY,MAAA,EAAyC;AACnD,IAAA,MAAA,CAAO,OAAA,EAAQ;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA,EAKA,QAAQ,MAAA,EAAyC;AAC/C,IAAA,MAAA,CAAO,OAAA,EAAQ;AAAA,EACjB;AACF","file":"index.js","sourcesContent":["/**\r\n * @suucha/ads-adsense\r\n *\r\n * Google AdSense 广告管理实现。\r\n * 动态加载 pagead2 脚本，提供 mountSlot / unmountSlot / refresh / enableAutoAds。\r\n */\r\n\r\nimport type { AdSlotHandle, AdSlotOptions, IAdManager } from '@suucha/core';\r\n\r\nexport interface AdSenseOptions {\r\n  /** 发布者 ID，必填，格式 'ca-pub-xxxxxxxxxxxxxxxx' */\r\n  client: string;\r\n  /** 是否启用自动广告，默认 false */\r\n  autoAds?: boolean;\r\n  /** 是否在 consent 未授予时不加载脚本 */\r\n  deferUntilConsent?: boolean;\r\n  /** 自定义脚本来源（用于测试或代理） */\r\n  scriptSrc?: string;\r\n}\r\n\r\nexport interface AdSenseSlotOptions extends AdSlotOptions {\r\n  /** 广告单元 ID（如 '1234567890'） */\r\n  slot?: string;\r\n  /** 广告格式，默认 'auto' */\r\n  format?: 'auto' | 'horizontal' | 'vertical' | 'rectangle';\r\n  /** 是否响应式，默认 true */\r\n  responsive?: boolean;\r\n}\r\n\r\ninterface AdSenseSlotHandleInternal extends AdSlotHandle {\r\n  refresh(): void;\r\n}\r\n\r\ndeclare global {\r\n  interface Window {\r\n    adsbygoogle?: unknown[];\r\n  }\r\n}\r\n\r\nconst DEFAULT_SCRIPT_SRC = 'https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js';\r\n\r\nlet nextSlotId = 1;\r\n\r\nexport class AdSenseManager implements IAdManager {\r\n  private readonly options: Required<AdSenseOptions>;\r\n  private loaded = false;\r\n  private readonly slots = new Map<string, AdSenseSlotHandleInternal>();\r\n\r\n  constructor(options: AdSenseOptions) {\r\n    if (!options.client || !options.client.startsWith('ca-pub-')) {\r\n      throw new Error(\r\n        `[AdSenseManager] client must start with 'ca-pub-', got: ${options.client}`,\r\n      );\r\n    }\r\n    this.options = {\r\n      autoAds: false,\r\n      deferUntilConsent: false,\r\n      scriptSrc: DEFAULT_SCRIPT_SRC,\r\n      ...options,\r\n    };\r\n\r\n    if (!this.options.deferUntilConsent) {\r\n      this.load();\r\n    }\r\n\r\n    if (this.options.autoAds) {\r\n      this.enableAutoAds();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 加载 AdSense 脚本\r\n   */\r\n  load(): void {\r\n    if (this.loaded) return;\r\n    if (typeof document === 'undefined') return;\r\n\r\n    const script = document.createElement('script');\r\n    script.async = true;\r\n    script.src = `${this.options.scriptSrc}?client=${this.options.client}`;\r\n    script.crossOrigin = 'anonymous';\r\n    document.head.appendChild(script);\r\n\r\n    window.adsbygoogle = window.adsbygoogle || [];\r\n    this.loaded = true;\r\n  }\r\n\r\n  /**\r\n   * 启用自动广告（AdSense 自动选择位置）\r\n   */\r\n  enableAutoAds(): void {\r\n    if (typeof window === 'undefined' || !window.adsbygoogle) return;\r\n    window.adsbygoogle.push({ google_ad_client: this.options.client });\r\n  }\r\n\r\n  /**\r\n   * 挂载广告位到 DOM\r\n   */\r\n  async mountSlot(slotOptions: AdSenseSlotOptions): Promise<AdSenseSlotHandleInternal> {\r\n    if (typeof document === 'undefined') {\r\n      throw new Error('[AdSenseManager] mountSlot requires a browser environment');\r\n    }\r\n    const container =\r\n      typeof slotOptions.container === 'string'\r\n        ? document.querySelector<HTMLElement>(slotOptions.container)\r\n        : slotOptions.container;\r\n    if (!container) {\r\n      throw new Error(\r\n        `[AdSenseManager] Container not found: ${slotOptions.container}`,\r\n      );\r\n    }\r\n\r\n    const ins = document.createElement('ins');\r\n    ins.className = 'adsbygoogle';\r\n    ins.style.display = 'block';\r\n    ins.setAttribute('data-ad-client', this.options.client);\r\n    if (slotOptions.slot) {\r\n      ins.setAttribute('data-ad-slot', slotOptions.slot);\r\n    }\r\n    ins.setAttribute(\r\n      'data-ad-format',\r\n      slotOptions.format ?? 'auto',\r\n    );\r\n    if (slotOptions.responsive !== false) {\r\n      ins.setAttribute('data-full-width-responsive', 'true');\r\n    }\r\n    container.appendChild(ins);\r\n\r\n    if (window.adsbygoogle) {\r\n      window.adsbygoogle.push({});\r\n    }\r\n\r\n    const id = `adsense_slot_${nextSlotId++}`;\r\n    const handle: AdSenseSlotHandleInternal = {\r\n      id,\r\n      slot: slotOptions.slot ?? '',\r\n      refresh: () => {\r\n        if (window.adsbygoogle) {\r\n          window.adsbygoogle.push({ refresh: () => {} });\r\n        }\r\n      },\r\n      destroy: () => {\r\n        ins.remove();\r\n        this.slots.delete(id);\r\n      },\r\n    };\r\n    this.slots.set(id, handle);\r\n    return handle;\r\n  }\r\n\r\n  /**\r\n   * 卸载广告位\r\n   */\r\n  unmountSlot(handle: AdSenseSlotHandleInternal): void {\r\n    handle.destroy();\r\n  }\r\n\r\n  /**\r\n   * 刷新广告位（重新竞价）\r\n   */\r\n  refresh(handle: AdSenseSlotHandleInternal): void {\r\n    handle.refresh();\r\n  }\r\n}\r\n\r\nexport type { AdSenseSlotHandleInternal };\r\n"]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@suucha/ads-adsense",
+  "version": "0.1.0",
+  "description": "Google AdSense ad manager for Suucha Web SDK",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "suucha",
+    "ads",
+    "adsense",
+    "google"
+  ],
+  "license": "MIT",
+  "author": "Suucha Studio",
+  "homepage": "https://github.com/suucha/Suucha.Web.Core#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/suucha/Suucha.Web.Core.git",
+    "directory": "packages/ads-adsense"
+  },
+  "bugs": {
+    "url": "https://github.com/suucha/Suucha.Web.Core/issues"
+  },
+  "dependencies": {
+    "@suucha/core": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}