@cookiemunch/sdk 0.8.0 → 0.9.0

package/dist/index.d.ts

@@ -20,7 +20,7 @@ import type { ConformanceReport } from './executor-conformance.js';
  * This package's version, sent in the default User-Agent. Cloudflare answers a request with
  * no recognisable User-Agent with `403 error code: 1010`; a test pins this to package.json.
  */
-export declare const SDK_VERSION = "0.8.0";
+export declare const SDK_VERSION = "0.9.0";
 export interface CookieMunchOptions {
     apiKey: string;
     /** "https://api.cookiemunch.net" — the /v1 prefix is appended automatically. */
@@ -358,11 +358,16 @@ export interface CookiePresetManifest {
         code?: string;
         message: string;
     }>;
+    /**
+     * About the copy in effect: `entry_skipped` / `storage_entry_skipped` (one entry was unreadable and left out; the
+     * rest still applies, and a left-out storage entry gives `name`), or `short_notice`.
+     */
     warnings?: Array<{
         rule?: number;
         path?: string;
         code?: string;
         message: string;
+        name?: string;
     }>;
 }
 /** PUT /v1/sites/:cbid/cookies/presets/custom — any vendor's embed manifest, by URL or as a body. */
@@ -766,6 +771,15 @@ export interface ButtonParityLint {
     /** 100 minus 20 per warning and 5 per notice, floored at 0. */
     score: number;
     suggestedReject: SuggestedRejectStyle[];
+    /** Laws taking effect within 90 days where at least 1% of the site's recent decisions come from. Absent when none. */
+    regulatoryWarnings?: Array<{
+        code: 'law_upcoming';
+        law: string;
+        effective: string;
+        daysUntil: number;
+        trafficShare: number;
+        message: string;
+    }>;
 }
 /**
  * Scrollbars on the surfaces Cookie Munch renders — the same shape on the banner theme (`theme.scrollbar`)
@@ -1851,6 +1865,44 @@ export interface RegulatoryFeedResult {
     stale: boolean;
     regulations: RegulationSummary[];
 }
+/** A law taking effect soon where a site's visitors are. */
+export interface SiteUpcomingRegulation {
+    id: string;
+    name: string;
+    jurisdiction: string;
+    effective: string;
+    /** Whole days from today; 0 = takes effect today. */
+    daysUntil: number;
+    /** Share (0–1) of the site's decisions in the window from where this law applies. */
+    trafficShare: number;
+    obligations: string[];
+    /** For a US state law: what changes for the banner. */
+    changes?: {
+        universalOptOut: boolean;
+        universalOptOutFrom?: string;
+        sensitiveOptIn: boolean;
+        minorOptInUnder: number;
+        minorsAds: 'opt-in' | 'prohibited';
+    };
+    source: string;
+}
+/** `GET /v1/sites/{cbid}/regulatory/upcoming`. */
+export interface SiteUpcomingRegulations {
+    reviewedAt: string;
+    ageDays: number;
+    reviewAfterDays: number;
+    stale: boolean;
+    days: number;
+    minShare: number;
+    /** The traffic window, epoch ms: the last 30 days. */
+    window: {
+        from: number;
+        to: number;
+    };
+    /** Decisions recorded in the window. */
+    decisions: number;
+    upcoming: SiteUpcomingRegulation[];
+}
 export interface AiInspectInput {
     prompt: string;
     purpose: string;
@@ -2999,6 +3051,14 @@ export interface CookieMunchClient {
         feed(jurisdictions?: string[]): Promise<RegulatoryFeedResult>;
         /** What takes effect within `days` (default 180), soonest first. */
         upcoming(days?: number): Promise<RegulatoryFeedResult>;
+        /**
+         * `GET /v1/sites/{cbid}/regulatory/upcoming`: what takes effect within `days` (default 90)
+         * where at least `minShare` (default 0.01) of this site's last 30 days of decisions came from.
+         */
+        upcomingForSite(cbid: string, opts?: {
+            days?: number;
+            minShare?: number;
+        }): Promise<SiteUpcomingRegulations>;
     };
     /** AI governance: policy, the inline gateway, inventory and lineage. */
     ai: {

package/dist/index.js

@@ -257,7 +257,7 @@ async function exchangeOperatorToken(input) {
 }
 
 // src/index.ts
-var SDK_VERSION = "0.8.0";
+var SDK_VERSION = "0.9.0";
 var CookieMunchApiError = class extends Error {
   constructor(status, message, code, body) {
     super(message);
@@ -569,7 +569,8 @@ function createCookieMunch(opts) {
     },
     regulatory: {
       feed: (jurisdictions) => get(`/regulatory/feed${qs({ jurisdictions: jurisdictions?.join(",") })}`),
-      upcoming: (days) => get(`/regulatory/upcoming${qs({ days })}`)
+      upcoming: (days) => get(`/regulatory/upcoming${qs({ days })}`),
+      upcomingForSite: (cbid, opts2) => get(`/sites/${enc(cbid)}/regulatory/upcoming${qs({ days: opts2?.days, minShare: opts2?.minShare })}`)
     },
     ai: {
       getPolicy: () => get("/ai/policy"),