@cookiemunch/sdk 0.1.0 → 0.1.1

package/dist/index.d.cts

@@ -111,7 +111,7 @@ interface DsarRequest {
     /** Where the subject said they are, when the intake captured it. */
     jurisdiction?: string;
     note?: string;
-    /** A test request: off the SLA board, labelled, and deletable with `dsar.delete`. */
+    /** A test request: off the SLA board, labelled, and deletable with `dsar.delete`. A closed request can be marked one with `dsar.markTest`. */
     test?: boolean;
 }
 interface DsarCreate {
@@ -251,13 +251,54 @@ interface CategorizedCookie {
     provider?: string;
     purpose?: string;
     expiry?: string;
-}
-/** A site's cookie declaration: the latest scan's categorized cookies. This is what
- *  GET /v1/sites/:cbid/cookies actually returns (a wrapper, not a bare array). */
+    /** Page URLs (multi-page scan) that set this cookie, earliest first. */
+    foundOnPages?: string[];
+    /** The site owner declared this cookie; it overrides the scan. */
+    declared?: boolean;
+    /** A declared `prefix*` wildcard row that no observed cookie matched yet. */
+    pattern?: boolean;
+    /** Why a person should look at it. Visitors see such cookies under "Unclassified". */
+    review?: 'unclassified' | 'category_disabled' | 'category_unknown';
+}
+/** A site's cookie declaration: the latest scan and observed visits with the site's own
+ *  declarations on top. This is what GET /v1/sites/:cbid/cookies returns. */
 interface CookieDeclaration {
-    /** Epoch-ms of the latest scan, or 0 if none. */
+    /** Epoch-ms of the latest scan or declaration change, or 0 if none. */
     updatedAt: number;
     cookies: CategorizedCookie[];
+    /** The site owner's declarations, as stored. */
+    declared?: DeclaredCookie[];
+}
+/** What the site owner says a cookie is (PUT /v1/sites/:cbid/cookies/:name). */
+interface DeclaredCookieInput {
+    /** A standard category or one of the site's `categories.custom` ids. Not `unclassified`. */
+    category: string;
+    /** Shown to visitors. */
+    purpose: string;
+    provider?: string;
+    expiry?: string;
+    domain?: string;
+    /** Treat the name as a prefix wildcard (a trailing `*` does the same). */
+    pattern?: boolean;
+}
+/** A stored declaration. */
+interface DeclaredCookie extends DeclaredCookieInput {
+    name: string;
+    updatedAt: number;
+}
+/** A warning about a write: e.g. the category is switched off for the site. */
+interface DeclarationWarning {
+    field: string;
+    reason: string;
+}
+/** What an import with `apply` declared, on top of what it read. */
+interface AppliedImport extends ImportedDeclaration {
+    applied: number;
+    skipped: Array<{
+        name: string;
+        reason: string;
+    }>;
+    warnings?: DeclarationWarning[];
 }
 /** @deprecated The server returns {@link CookieDeclaration}; kept only for back-compat. */
 interface SiteCookie {
@@ -335,6 +376,10 @@ interface ConfigChange {
     from?: unknown;
     to?: unknown;
 }
+/** `PUT …/config` options. `keep: 'unspecified'` keeps the stored value of every top-level field the body omits. */
+interface PutConfigOptions {
+    keep?: 'unspecified';
+}
 /** What a config write would do (`?dryRun=1`) — nothing is saved. */
 interface ConfigDryRun {
     dryRun: true;
@@ -1116,17 +1161,27 @@ interface CookieMunchClient {
         get(cbid: string): Promise<Site>;
         delete(cbid: string): Promise<void>;
         getConfig(cbid: string): Promise<SiteConfig>;
-        /** Replaces the whole config — a top-level field you omit reverts to its default. */
-        putConfig(cbid: string, config: SiteConfig): Promise<SiteConfig>;
-        /** Changes some of the config — omitted fields keep their stored value. */
+        /**
+         * Replaces the whole config — a top-level field you omit reverts to its default. With
+         * `{ keep: 'unspecified' }` (`?keep=unspecified`) an omitted top-level field keeps its
+         * stored value instead; each field you send is still replaced whole, and one sent as
+         * `null` reverts to its default.
+         */
+        putConfig(cbid: string, config: SiteConfig, opts?: PutConfigOptions): Promise<SiteConfig>;
+        /**
+         * Changes some of the config — a JSON Merge Patch (RFC 7386): omitted fields keep their
+         * stored value, nested objects merge, and `null` removes a field (it takes its default):
+         * `{ banner: { i18n: { es: null } } }` drops the Spanish override. Arrays replace whole.
+         */
         patchConfig(cbid: string, config: Partial<SiteConfig>): Promise<SiteConfig>;
         /**
          * Preview a config write without saving it: the merged result and a diff. `mode: 'put'`
-         * previews a replace (the diff then lists everything that would revert to its default).
+         * previews a replace (the diff then lists everything that would revert to its default);
+         * add `keep: 'unspecified'` to preview a replace that keeps omitted fields.
          */
         dryRunConfig(cbid: string, config: Partial<SiteConfig>, opts?: {
             mode?: 'patch' | 'put';
-        }): Promise<ConfigDryRun>;
+        } & PutConfigOptions): Promise<ConfigDryRun>;
         cookies(cbid: string): Promise<CookieDeclaration>;
         scan(cbid: string): Promise<ScanStatus>;
         scanStatus(cbid: string): Promise<ScanStatus>;
@@ -1155,6 +1210,36 @@ interface CookieMunchClient {
          * wrong category is a tag firing against a refusal, so the result is for review.
          */
         importDeclaration(cbid: string, data: string): Promise<ImportedDeclaration>;
+        /**
+         * Import AND declare: every row that mapped to one of our categories and has a purpose
+         * is declared; the rest come back in `skipped`. Already-declared cookies are kept
+         * unless `overwrite`.
+         */
+        applyImport(cbid: string, data: string, opts?: {
+            overwrite?: boolean;
+        }): Promise<AppliedImport>;
+        /**
+         * Declare what one cookie is. Overrides scanned, observed and database classification
+         * in the API, the preference modal and `data-cc="declaration"`. A name ending in `*`
+         * declares a prefix wildcard.
+         */
+        declareCookie(cbid: string, name: string, input: DeclaredCookieInput): Promise<{
+            cookie: DeclaredCookie;
+            warnings?: DeclarationWarning[];
+        }>;
+        /** Remove a declaration; the scanned classification applies again. */
+        undeclareCookie(cbid: string, name: string): Promise<void>;
+        /** Declare many at once (all-or-nothing). `replace` also removes declarations not listed. */
+        declareCookies(cbid: string, cookies: Array<DeclaredCookieInput & {
+            name: string;
+        }>, opts?: {
+            replace?: boolean;
+        }): Promise<{
+            declared: DeclaredCookie[];
+            saved: number;
+            removed: number;
+            warnings?: DeclarationWarning[];
+        }>;
         snippet(cbid: string, opts?: SnippetOptions): Promise<InstallSnippet>;
         /**
          * Mint a short-lived signed token to see the banner as a visitor in a given region and
@@ -1235,6 +1320,15 @@ interface CookieMunchClient {
          * real request cannot be deleted (409 `not_a_test_request`); the deletion is audited.
          */
         delete(id: string): Promise<void>;
+        /**
+         * Mark a CLOSED request (completed or rejected) as a test, after the fact — for trials
+         * filed before `test` existed. An open one is refused (409 `request_not_closed`). Audited
+         * as `dsar.marked_test`; afterwards `delete` works on it. `changed` is false on a repeat.
+         */
+        markTest(id: string): Promise<{
+            request: DsarRequest;
+            changed: boolean;
+        }>;
     };
     vendors: {
         list(): Promise<ScoredVendor[]>;
@@ -1617,4 +1711,4 @@ interface CookieMunchClient {
 }
 declare function createCookieMunch(opts: CookieMunchOptions): CookieMunchClient;
 
-export { type AbResult, type AccountOrg, type AccountOrgs, type AdPersonalizationInput, type AiInspectInput, type AiInspectResult, type ApiKey, type ApiKeyIssueInput, type ApiKeyIssued, type ApiKeyPrefix, type ApiKeyUpdate, type AssetUpload, type AuditEntry, type BannerRecord, type BannerSummary, type BlockedReport, type BrandExtractionResult, type BrandKit, type BrandKitCreate, type BrandSuggestion, type BulkSiteInput, type BulkSiteResult, type CategorizedCookie, type ChildKeyInput, type ConfigChange, type ConfigDryRun, type ConfigWarning, type ConsentDay, type ConsentDecisionInput, type ConsentIngestInput, type ConsentLogRow, type CookieDeclaration, CookieMunchApiError, type CookieMunchClient, type CookieMunchOptions, type CspSources, type DsarCreate, type DsarEraseResult, type DsarExecutor, type DsarExecutorCreated, type DsarExecutorInput, type DsarExportResult, type DsarRequest, type DsarStatus, type DsarTask, type DsarTaskEvent, type DsarTaskExport, type DsarTaskLogEntry, type DsarTaskOutcome, type DsarType, type EnforcementRuleInput, type ExecutorProfile, type ExecutorTestInput, type ExecutorTestResult, type FlowIssue, type FlowOp, type FlowOpResponse, type FulfillmentOp, type Identifier, type Identity, type ImportedCookie, type ImportedDeclaration, type InstallSnippet, type LegalBasis, type LogQuery, type Member, type OptInMethod, type Org, type OrgUpdate, type PlanSource, type PolicyOptions, type PreferenceItem, type PreferenceRecord, type PreviewToken, type PreviewTokenOptions, type ProfileAttributeInput, type RangeQuery, type Regulation, type RegulationSummary, type RegulatoryFeedResult, type ResellerChild, type ResellerChildCreate, type ResellerChildList, type ResellerChildPatch, type RiskScore, type RopaEntry, type RopaInput, type ScanResult, type ScanStatus, type ScoredVendor, type SessionAnalysisInput, type SignedReceipt, type Site, type SiteConfig, type SiteCookie, type SiteCreate, type SiteFlow, type SnippetOptions, type SubscriptionTopicInput, type SupportedLanguage, type Usage, type VendorInput, type VendorRecord, type VerifyResult, type VerifyWebhookInput, type WebhookCreate, type WebhookDeadLetter, type WebhookSubscription, type WebhookTestResult, type WebhookUpdate, createCookieMunch, verifyWebhookSignature };
+export { type AbResult, type AccountOrg, type AccountOrgs, type AdPersonalizationInput, type AiInspectInput, type AiInspectResult, type ApiKey, type ApiKeyIssueInput, type ApiKeyIssued, type ApiKeyPrefix, type ApiKeyUpdate, type AppliedImport, type AssetUpload, type AuditEntry, type BannerRecord, type BannerSummary, type BlockedReport, type BrandExtractionResult, type BrandKit, type BrandKitCreate, type BrandSuggestion, type BulkSiteInput, type BulkSiteResult, type CategorizedCookie, type ChildKeyInput, type ConfigChange, type ConfigDryRun, type ConfigWarning, type ConsentDay, type ConsentDecisionInput, type ConsentIngestInput, type ConsentLogRow, type CookieDeclaration, CookieMunchApiError, type CookieMunchClient, type CookieMunchOptions, type CspSources, type DeclarationWarning, type DeclaredCookie, type DeclaredCookieInput, type DsarCreate, type DsarEraseResult, type DsarExecutor, type DsarExecutorCreated, type DsarExecutorInput, type DsarExportResult, type DsarRequest, type DsarStatus, type DsarTask, type DsarTaskEvent, type DsarTaskExport, type DsarTaskLogEntry, type DsarTaskOutcome, type DsarType, type EnforcementRuleInput, type ExecutorProfile, type ExecutorTestInput, type ExecutorTestResult, type FlowIssue, type FlowOp, type FlowOpResponse, type FulfillmentOp, type Identifier, type Identity, type ImportedCookie, type ImportedDeclaration, type InstallSnippet, type LegalBasis, type LogQuery, type Member, type OptInMethod, type Org, type OrgUpdate, type PlanSource, type PolicyOptions, type PreferenceItem, type PreferenceRecord, type PreviewToken, type PreviewTokenOptions, type ProfileAttributeInput, type PutConfigOptions, type RangeQuery, type Regulation, type RegulationSummary, type RegulatoryFeedResult, type ResellerChild, type ResellerChildCreate, type ResellerChildList, type ResellerChildPatch, type RiskScore, type RopaEntry, type RopaInput, type ScanResult, type ScanStatus, type ScoredVendor, type SessionAnalysisInput, type SignedReceipt, type Site, type SiteConfig, type SiteCookie, type SiteCreate, type SiteFlow, type SnippetOptions, type SubscriptionTopicInput, type SupportedLanguage, type Usage, type VendorInput, type VendorRecord, type VerifyResult, type VerifyWebhookInput, type WebhookCreate, type WebhookDeadLetter, type WebhookSubscription, type WebhookTestResult, type WebhookUpdate, createCookieMunch, verifyWebhookSignature };

package/dist/index.d.ts

@@ -111,7 +111,7 @@ interface DsarRequest {
     /** Where the subject said they are, when the intake captured it. */
     jurisdiction?: string;
     note?: string;
-    /** A test request: off the SLA board, labelled, and deletable with `dsar.delete`. */
+    /** A test request: off the SLA board, labelled, and deletable with `dsar.delete`. A closed request can be marked one with `dsar.markTest`. */
     test?: boolean;
 }
 interface DsarCreate {
@@ -251,13 +251,54 @@ interface CategorizedCookie {
     provider?: string;
     purpose?: string;
     expiry?: string;
-}
-/** A site's cookie declaration: the latest scan's categorized cookies. This is what
- *  GET /v1/sites/:cbid/cookies actually returns (a wrapper, not a bare array). */
+    /** Page URLs (multi-page scan) that set this cookie, earliest first. */
+    foundOnPages?: string[];
+    /** The site owner declared this cookie; it overrides the scan. */
+    declared?: boolean;
+    /** A declared `prefix*` wildcard row that no observed cookie matched yet. */
+    pattern?: boolean;
+    /** Why a person should look at it. Visitors see such cookies under "Unclassified". */
+    review?: 'unclassified' | 'category_disabled' | 'category_unknown';
+}
+/** A site's cookie declaration: the latest scan and observed visits with the site's own
+ *  declarations on top. This is what GET /v1/sites/:cbid/cookies returns. */
 interface CookieDeclaration {
-    /** Epoch-ms of the latest scan, or 0 if none. */
+    /** Epoch-ms of the latest scan or declaration change, or 0 if none. */
     updatedAt: number;
     cookies: CategorizedCookie[];
+    /** The site owner's declarations, as stored. */
+    declared?: DeclaredCookie[];
+}
+/** What the site owner says a cookie is (PUT /v1/sites/:cbid/cookies/:name). */
+interface DeclaredCookieInput {
+    /** A standard category or one of the site's `categories.custom` ids. Not `unclassified`. */
+    category: string;
+    /** Shown to visitors. */
+    purpose: string;
+    provider?: string;
+    expiry?: string;
+    domain?: string;
+    /** Treat the name as a prefix wildcard (a trailing `*` does the same). */
+    pattern?: boolean;
+}
+/** A stored declaration. */
+interface DeclaredCookie extends DeclaredCookieInput {
+    name: string;
+    updatedAt: number;
+}
+/** A warning about a write: e.g. the category is switched off for the site. */
+interface DeclarationWarning {
+    field: string;
+    reason: string;
+}
+/** What an import with `apply` declared, on top of what it read. */
+interface AppliedImport extends ImportedDeclaration {
+    applied: number;
+    skipped: Array<{
+        name: string;
+        reason: string;
+    }>;
+    warnings?: DeclarationWarning[];
 }
 /** @deprecated The server returns {@link CookieDeclaration}; kept only for back-compat. */
 interface SiteCookie {
@@ -335,6 +376,10 @@ interface ConfigChange {
     from?: unknown;
     to?: unknown;
 }
+/** `PUT …/config` options. `keep: 'unspecified'` keeps the stored value of every top-level field the body omits. */
+interface PutConfigOptions {
+    keep?: 'unspecified';
+}
 /** What a config write would do (`?dryRun=1`) — nothing is saved. */
 interface ConfigDryRun {
     dryRun: true;
@@ -1116,17 +1161,27 @@ interface CookieMunchClient {
         get(cbid: string): Promise<Site>;
         delete(cbid: string): Promise<void>;
         getConfig(cbid: string): Promise<SiteConfig>;
-        /** Replaces the whole config — a top-level field you omit reverts to its default. */
-        putConfig(cbid: string, config: SiteConfig): Promise<SiteConfig>;
-        /** Changes some of the config — omitted fields keep their stored value. */
+        /**
+         * Replaces the whole config — a top-level field you omit reverts to its default. With
+         * `{ keep: 'unspecified' }` (`?keep=unspecified`) an omitted top-level field keeps its
+         * stored value instead; each field you send is still replaced whole, and one sent as
+         * `null` reverts to its default.
+         */
+        putConfig(cbid: string, config: SiteConfig, opts?: PutConfigOptions): Promise<SiteConfig>;
+        /**
+         * Changes some of the config — a JSON Merge Patch (RFC 7386): omitted fields keep their
+         * stored value, nested objects merge, and `null` removes a field (it takes its default):
+         * `{ banner: { i18n: { es: null } } }` drops the Spanish override. Arrays replace whole.
+         */
         patchConfig(cbid: string, config: Partial<SiteConfig>): Promise<SiteConfig>;
         /**
          * Preview a config write without saving it: the merged result and a diff. `mode: 'put'`
-         * previews a replace (the diff then lists everything that would revert to its default).
+         * previews a replace (the diff then lists everything that would revert to its default);
+         * add `keep: 'unspecified'` to preview a replace that keeps omitted fields.
          */
         dryRunConfig(cbid: string, config: Partial<SiteConfig>, opts?: {
             mode?: 'patch' | 'put';
-        }): Promise<ConfigDryRun>;
+        } & PutConfigOptions): Promise<ConfigDryRun>;
         cookies(cbid: string): Promise<CookieDeclaration>;
         scan(cbid: string): Promise<ScanStatus>;
         scanStatus(cbid: string): Promise<ScanStatus>;
@@ -1155,6 +1210,36 @@ interface CookieMunchClient {
          * wrong category is a tag firing against a refusal, so the result is for review.
          */
         importDeclaration(cbid: string, data: string): Promise<ImportedDeclaration>;
+        /**
+         * Import AND declare: every row that mapped to one of our categories and has a purpose
+         * is declared; the rest come back in `skipped`. Already-declared cookies are kept
+         * unless `overwrite`.
+         */
+        applyImport(cbid: string, data: string, opts?: {
+            overwrite?: boolean;
+        }): Promise<AppliedImport>;
+        /**
+         * Declare what one cookie is. Overrides scanned, observed and database classification
+         * in the API, the preference modal and `data-cc="declaration"`. A name ending in `*`
+         * declares a prefix wildcard.
+         */
+        declareCookie(cbid: string, name: string, input: DeclaredCookieInput): Promise<{
+            cookie: DeclaredCookie;
+            warnings?: DeclarationWarning[];
+        }>;
+        /** Remove a declaration; the scanned classification applies again. */
+        undeclareCookie(cbid: string, name: string): Promise<void>;
+        /** Declare many at once (all-or-nothing). `replace` also removes declarations not listed. */
+        declareCookies(cbid: string, cookies: Array<DeclaredCookieInput & {
+            name: string;
+        }>, opts?: {
+            replace?: boolean;
+        }): Promise<{
+            declared: DeclaredCookie[];
+            saved: number;
+            removed: number;
+            warnings?: DeclarationWarning[];
+        }>;
         snippet(cbid: string, opts?: SnippetOptions): Promise<InstallSnippet>;
         /**
          * Mint a short-lived signed token to see the banner as a visitor in a given region and
@@ -1235,6 +1320,15 @@ interface CookieMunchClient {
          * real request cannot be deleted (409 `not_a_test_request`); the deletion is audited.
          */
         delete(id: string): Promise<void>;
+        /**
+         * Mark a CLOSED request (completed or rejected) as a test, after the fact — for trials
+         * filed before `test` existed. An open one is refused (409 `request_not_closed`). Audited
+         * as `dsar.marked_test`; afterwards `delete` works on it. `changed` is false on a repeat.
+         */
+        markTest(id: string): Promise<{
+            request: DsarRequest;
+            changed: boolean;
+        }>;
     };
     vendors: {
         list(): Promise<ScoredVendor[]>;
@@ -1617,4 +1711,4 @@ interface CookieMunchClient {
 }
 declare function createCookieMunch(opts: CookieMunchOptions): CookieMunchClient;
 
-export { type AbResult, type AccountOrg, type AccountOrgs, type AdPersonalizationInput, type AiInspectInput, type AiInspectResult, type ApiKey, type ApiKeyIssueInput, type ApiKeyIssued, type ApiKeyPrefix, type ApiKeyUpdate, type AssetUpload, type AuditEntry, type BannerRecord, type BannerSummary, type BlockedReport, type BrandExtractionResult, type BrandKit, type BrandKitCreate, type BrandSuggestion, type BulkSiteInput, type BulkSiteResult, type CategorizedCookie, type ChildKeyInput, type ConfigChange, type ConfigDryRun, type ConfigWarning, type ConsentDay, type ConsentDecisionInput, type ConsentIngestInput, type ConsentLogRow, type CookieDeclaration, CookieMunchApiError, type CookieMunchClient, type CookieMunchOptions, type CspSources, type DsarCreate, type DsarEraseResult, type DsarExecutor, type DsarExecutorCreated, type DsarExecutorInput, type DsarExportResult, type DsarRequest, type DsarStatus, type DsarTask, type DsarTaskEvent, type DsarTaskExport, type DsarTaskLogEntry, type DsarTaskOutcome, type DsarType, type EnforcementRuleInput, type ExecutorProfile, type ExecutorTestInput, type ExecutorTestResult, type FlowIssue, type FlowOp, type FlowOpResponse, type FulfillmentOp, type Identifier, type Identity, type ImportedCookie, type ImportedDeclaration, type InstallSnippet, type LegalBasis, type LogQuery, type Member, type OptInMethod, type Org, type OrgUpdate, type PlanSource, type PolicyOptions, type PreferenceItem, type PreferenceRecord, type PreviewToken, type PreviewTokenOptions, type ProfileAttributeInput, type RangeQuery, type Regulation, type RegulationSummary, type RegulatoryFeedResult, type ResellerChild, type ResellerChildCreate, type ResellerChildList, type ResellerChildPatch, type RiskScore, type RopaEntry, type RopaInput, type ScanResult, type ScanStatus, type ScoredVendor, type SessionAnalysisInput, type SignedReceipt, type Site, type SiteConfig, type SiteCookie, type SiteCreate, type SiteFlow, type SnippetOptions, type SubscriptionTopicInput, type SupportedLanguage, type Usage, type VendorInput, type VendorRecord, type VerifyResult, type VerifyWebhookInput, type WebhookCreate, type WebhookDeadLetter, type WebhookSubscription, type WebhookTestResult, type WebhookUpdate, createCookieMunch, verifyWebhookSignature };
+export { type AbResult, type AccountOrg, type AccountOrgs, type AdPersonalizationInput, type AiInspectInput, type AiInspectResult, type ApiKey, type ApiKeyIssueInput, type ApiKeyIssued, type ApiKeyPrefix, type ApiKeyUpdate, type AppliedImport, type AssetUpload, type AuditEntry, type BannerRecord, type BannerSummary, type BlockedReport, type BrandExtractionResult, type BrandKit, type BrandKitCreate, type BrandSuggestion, type BulkSiteInput, type BulkSiteResult, type CategorizedCookie, type ChildKeyInput, type ConfigChange, type ConfigDryRun, type ConfigWarning, type ConsentDay, type ConsentDecisionInput, type ConsentIngestInput, type ConsentLogRow, type CookieDeclaration, CookieMunchApiError, type CookieMunchClient, type CookieMunchOptions, type CspSources, type DeclarationWarning, type DeclaredCookie, type DeclaredCookieInput, type DsarCreate, type DsarEraseResult, type DsarExecutor, type DsarExecutorCreated, type DsarExecutorInput, type DsarExportResult, type DsarRequest, type DsarStatus, type DsarTask, type DsarTaskEvent, type DsarTaskExport, type DsarTaskLogEntry, type DsarTaskOutcome, type DsarType, type EnforcementRuleInput, type ExecutorProfile, type ExecutorTestInput, type ExecutorTestResult, type FlowIssue, type FlowOp, type FlowOpResponse, type FulfillmentOp, type Identifier, type Identity, type ImportedCookie, type ImportedDeclaration, type InstallSnippet, type LegalBasis, type LogQuery, type Member, type OptInMethod, type Org, type OrgUpdate, type PlanSource, type PolicyOptions, type PreferenceItem, type PreferenceRecord, type PreviewToken, type PreviewTokenOptions, type ProfileAttributeInput, type PutConfigOptions, type RangeQuery, type Regulation, type RegulationSummary, type RegulatoryFeedResult, type ResellerChild, type ResellerChildCreate, type ResellerChildList, type ResellerChildPatch, type RiskScore, type RopaEntry, type RopaInput, type ScanResult, type ScanStatus, type ScoredVendor, type SessionAnalysisInput, type SignedReceipt, type Site, type SiteConfig, type SiteCookie, type SiteCreate, type SiteFlow, type SnippetOptions, type SubscriptionTopicInput, type SupportedLanguage, type Usage, type VendorInput, type VendorRecord, type VerifyResult, type VerifyWebhookInput, type WebhookCreate, type WebhookDeadLetter, type WebhookSubscription, type WebhookTestResult, type WebhookUpdate, createCookieMunch, verifyWebhookSignature };

package/dist/index.js

@@ -91,9 +91,13 @@ function createCookieMunch(opts) {
         await request("DELETE", `/sites/${enc(cbid)}`);
       },
       getConfig: (cbid) => get(`/sites/${enc(cbid)}/config`),
-      putConfig: (cbid, config) => request("PUT", `/sites/${enc(cbid)}/config`, config),
+      putConfig: (cbid, config, opts2) => request("PUT", `/sites/${enc(cbid)}/config${qs({ keep: opts2?.keep })}`, config),
       patchConfig: (cbid, config) => request("PATCH", `/sites/${enc(cbid)}/config`, config),
-      dryRunConfig: (cbid, config, opts2) => request(opts2?.mode === "put" ? "PUT" : "PATCH", `/sites/${enc(cbid)}/config?dryRun=1`, config),
+      dryRunConfig: (cbid, config, opts2) => request(
+        opts2?.mode === "put" ? "PUT" : "PATCH",
+        `/sites/${enc(cbid)}/config${qs({ dryRun: 1, keep: opts2?.mode === "put" ? opts2.keep : void 0 })}`,
+        config
+      ),
       cookies: (cbid) => get(`/sites/${enc(cbid)}/cookies`),
       scan: (cbid) => request("POST", `/sites/${enc(cbid)}/scan`),
       scanStatus: (cbid) => get(`/sites/${enc(cbid)}/scan`),
@@ -109,6 +113,12 @@ function createCookieMunch(opts) {
       banner: (cbid) => get(`/sites/${enc(cbid)}/banner`),
       blocked: (cbid) => get(`/sites/${enc(cbid)}/blocked`),
       importDeclaration: (cbid, data) => request("POST", `/sites/${enc(cbid)}/import`, { data }),
+      applyImport: (cbid, data, o) => request("POST", `/sites/${enc(cbid)}/import${qs({ apply: "1", overwrite: o?.overwrite ? "1" : void 0 })}`, { data }),
+      declareCookie: (cbid, name, input) => request("PUT", `/sites/${enc(cbid)}/cookies/${enc(name)}`, input),
+      undeclareCookie: async (cbid, name) => {
+        await request("DELETE", `/sites/${enc(cbid)}/cookies/${enc(name)}`);
+      },
+      declareCookies: (cbid, cookies, o) => request("PUT", `/sites/${enc(cbid)}/cookies`, { cookies, ...o?.replace ? { replace: true } : {} }),
       snippet: (cbid, opts2) => get(`/sites/${enc(cbid)}/snippet${qs({ blockingmode: opts2?.blockingMode, culture: opts2?.culture })}`),
       previewToken: (cbid, o) => request("POST", `/sites/${enc(cbid)}/preview-token`, o ?? {}),
       verify: (cbid, method) => request("POST", `/sites/${enc(cbid)}/verify`, { method }),
@@ -156,7 +166,8 @@ function createCookieMunch(opts) {
       export: (id, cbid, stamp) => request("POST", `/dsar/${enc(id)}/export`, { cbid, stamp }),
       delete: async (id) => {
         await request("DELETE", `/dsar/${enc(id)}`);
-      }
+      },
+      markTest: (id) => request("POST", `/dsar/${enc(id)}/mark-test`)
     },
     vendors: {
       list: () => get("/vendors"),