@jskit-ai/agent-docs 0.1.154 → 0.1.156

package/skills/jskit/references/patterns/rewards/google-rewarded/example/googlePublisherTag.js

@@ -0,0 +1,142 @@
+let gptLoadPromise = null;
+let gptServicesEnabled = false;
+
+async function ensureGooglePublisherTagLoaded() {
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    throw new Error("Rewarded runtime requires a browser environment.");
+  }
+
+  if (window.googletag?.apiReady === true) {
+    return window.googletag;
+  }
+  if (gptLoadPromise) {
+    return gptLoadPromise;
+  }
+
+  window.googletag ||= { cmd: [] };
+  gptLoadPromise = new Promise((resolve, reject) => {
+    const existingScript = document.querySelector('script[data-jskit-rewarded-gpt="true"]');
+    if (existingScript) {
+      existingScript.addEventListener("load", () => resolve(window.googletag), { once: true });
+      existingScript.addEventListener("error", () => reject(new Error("Failed to load Google Publisher Tag.")), { once: true });
+      return;
+    }
+
+    const script = document.createElement("script");
+    script.async = true;
+    script.src = "https://securepubads.g.doubleclick.net/tag/js/gpt.js";
+    script.dataset.jskitRewardedGpt = "true";
+    script.addEventListener("load", () => resolve(window.googletag), { once: true });
+    script.addEventListener("error", () => reject(new Error("Failed to load Google Publisher Tag.")), { once: true });
+    document.head.appendChild(script);
+  }).catch((error) => {
+    gptLoadPromise = null;
+    throw error;
+  });
+
+  return gptLoadPromise;
+}
+
+function launchGoogleRewardedAd({
+  providerConfig,
+  onReady = null,
+  onGranted = null,
+  onClosed = null,
+  onUnavailable = null
+} = {}) {
+  if (providerConfig?.provider !== "google-publisher-tag") {
+    throw new TypeError("Google delivery requires provider google-publisher-tag.");
+  }
+  const placement = String(providerConfig?.placement || "").trim();
+  if (!placement) throw new TypeError("Rewarded delivery requires placement.");
+  return ensureGooglePublisherTagLoaded().then((googletag) =>
+    new Promise((resolve, reject) => {
+      googletag.cmd.push(() => {
+        const pubads = googletag.pubads();
+        const rewardedFormat = googletag?.enums?.OutOfPageFormat?.REWARDED;
+        if (!rewardedFormat) {
+          reject(new Error("Rewarded ads are not supported by this GPT build."));
+          return;
+        }
+
+        const slot = googletag.defineOutOfPageSlot(placement, rewardedFormat);
+        if (!slot) {
+          Promise.resolve(onUnavailable?.()).finally(() => {
+            reject(new Error("Rewarded ads are not available on this page."));
+          });
+          return;
+        }
+
+        let readySeen = false;
+        let settled = false;
+
+        const cleanup = () => {
+          if (typeof pubads.removeEventListener === "function") {
+            pubads.removeEventListener("rewardedSlotReady", handleReady);
+            pubads.removeEventListener("rewardedSlotGranted", handleGranted);
+            pubads.removeEventListener("rewardedSlotClosed", handleClosed);
+          }
+          if (typeof googletag.destroySlots === "function") {
+            googletag.destroySlots([slot]);
+          }
+        };
+
+        const handleReady = async (event) => {
+          if (event?.slot !== slot || settled) {
+            return;
+          }
+          readySeen = true;
+          await Promise.resolve(onReady?.());
+          if (typeof event.makeRewardedVisible === "function") {
+            event.makeRewardedVisible();
+          }
+        };
+
+        const handleGranted = async (event) => {
+          if (event?.slot !== slot || settled) {
+            return;
+          }
+          await Promise.resolve(onGranted?.());
+        };
+
+        const handleClosed = async (event) => {
+          if (event?.slot !== slot || settled) {
+            return;
+          }
+          settled = true;
+          cleanup();
+          try {
+            await Promise.resolve(onClosed?.());
+            resolve();
+          } catch (error) {
+            reject(error);
+          }
+        };
+
+        pubads.addEventListener("rewardedSlotReady", handleReady);
+        pubads.addEventListener("rewardedSlotGranted", handleGranted);
+        pubads.addEventListener("rewardedSlotClosed", handleClosed);
+        slot.addService(pubads);
+
+        if (!gptServicesEnabled) {
+          googletag.enableServices();
+          gptServicesEnabled = true;
+        }
+
+        googletag.display(slot);
+        window.setTimeout(() => {
+          if (settled || readySeen) {
+            return;
+          }
+          settled = true;
+          cleanup();
+          Promise.resolve(onUnavailable?.()).finally(() => {
+            reject(new Error("No rewarded ad was available."));
+          });
+        }, 10000);
+      });
+    })
+  );
+}
+
+export { launchGoogleRewardedAd };

package/skills/jskit/references/patterns/server/feature-package/example/booking-engine/package.json

@@ -5,7 +5,7 @@
   "private": true,
   "type": "module",
   "dependencies": {
-    "@jskit-ai/kernel": "0.1.182",
+    "@jskit-ai/kernel": "0.1.184",
     "json-rest-schema": "^1.0.17"
   },
   "exports": {

package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users/package.json

@@ -9,8 +9,8 @@
     "./shared": "./src/shared/index.js"
   },
   "dependencies": {
-    "@jskit-ai/crud-core": "0.1.193",
-    "@jskit-ai/resource-crud-core": "0.1.124"
+    "@jskit-ai/crud-core": "0.1.195",
+    "@jskit-ai/resource-crud-core": "0.1.126"
   },
   "jskit": {
     "kind": "runtime",

package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users-workspace/package.json

@@ -9,9 +9,9 @@
     "./shared": "./src/shared/index.js"
   },
   "dependencies": {
-    "@jskit-ai/crud-core": "0.1.193",
-    "@jskit-ai/resource-crud-core": "0.1.124",
-    "@jskit-ai/workspaces-core": "0.1.160"
+    "@jskit-ai/crud-core": "0.1.195",
+    "@jskit-ai/resource-crud-core": "0.1.126",
+    "@jskit-ai/workspaces-core": "0.1.162"
   },
   "jskit": {
     "kind": "runtime",

package/reference/autogen/packages/google-rewarded-web.md

@@ -1,65 +0,0 @@
-# packages/google-rewarded-web
-
-Generated by `npm run agent-docs:build`.
-Do not edit manually.
-
-Generated inventory for `packages/google-rewarded-web`.
-Use this on demand; do not load the full index at startup.
-
-## Scope
-- Source: `packages/google-rewarded-web/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
-
-## Sections
-
-### src
-
-### `src/client/components/GoogleRewardedGateHost.vue`
-Exports
-- None
-Local functions
-- `handleWatchClick()`
-- `handleCancelClick()`
-- `handleDismissError()`
-
-### `src/client/composables/useGoogleRewardedRuntime.js`
-Exports
-- `useGoogleRewardedRuntime()`
-
-### `src/client/index.js`
-Exports
-- `GoogleRewardedClientProvider`
-- `GoogleRewardedGateHost`
-- `GOOGLE_REWARDED_RUNTIME_INJECTION_KEY`
-- `createGoogleRewardedRuntime`
-- `useGoogleRewardedRuntime`
-
-### `src/client/providers/GoogleRewardedClientProvider.js`
-Exports
-- `GoogleRewardedClientProvider`
-
-### `src/client/runtime/googleRewardedRuntime.js`
-Exports
-- `GOOGLE_REWARDED_RUNTIME_INJECTION_KEY`
-- `createGoogleRewardedRuntime()`
-Local functions
-- `createInitialState()`
-- `applyState(target, source)`
-- `normalizeWorkspaceSlug(value = "")`
-- `isWellFormedGateState(gateState = null)`
-- `buildApiPath(workspaceSlug = "", action = "", query = null)`
-- `ensureGooglePublisherTagLoaded()`
-- `launchRewardedSlot({ adUnitPath = "", onReady = null, onGranted = null, onClosed = null, onUnavailable = null } = {})`
-- `requestCurrent(input = {})`
-
-### `src/index.js`
-Exports
-- None
-
-### `src/server/index.js`
-Exports
-- None
-
-### `src/shared/index.js`
-Exports
-- None