@oxy.so/contracts 4.21.0 → 4.23.0

package/dist/types/client/contentClaims.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Content claims (ADR 0043 D10) — the constants of the public "Report content
+ * / rights claim" intake and of a claim's review, without Zod. Schemas:
+ * `../contentClaims.ts`.
+ *
+ * Part of `@oxy.so/contracts/client`: never import `zod` here (see `./check.ts`).
+ */
+/** What a claim asserts. */
+export declare const CONTENT_CLAIM_KINDS: readonly ["copyright", "trademark", "privacy", "illegal_content", "other"];
+export type ContentClaimKind = (typeof CONTENT_CLAIM_KINDS)[number];
+/** Who the claimant is to the content. */
+export declare const CLAIMANT_RELATIONSHIPS: readonly ["rights_holder", "authorized_agent", "affected_person", "other"];
+export type ClaimantRelationship = (typeof CLAIMANT_RELATIONSHIPS)[number];
+/** The bounds of a submission. The website fills its validation messages from these. */
+export declare const CONTENT_CLAIM_LIMITS: {
+    readonly minUrls: 1;
+    readonly maxUrls: 20;
+    readonly maxUrlLength: 2048;
+    readonly minDescription: 20;
+    readonly maxDescription: 5000;
+    readonly maxName: 200;
+    readonly maxOrganization: 200;
+    readonly maxEmail: 254;
+};
+/**
+ * Where a claim is in its review.
+ *
+ * `received → reviewing → actioned | rejected`; an actioned claim can be
+ * answered by the content's owner (`counter_noticed`), which ends either in
+ * `reinstated` (the content is served again) or `upheld` (it stays blocked).
+ * A claim can also be rejected straight from `received`.
+ */
+export declare const CONTENT_CLAIM_STATES: readonly ["received", "reviewing", "actioned", "rejected", "counter_noticed", "reinstated", "upheld"];
+export type ContentClaimState = (typeof CONTENT_CLAIM_STATES)[number];
+/** The states in which a claim is still open: its evidence is kept and its blocks can change. */
+export declare const OPEN_CONTENT_CLAIM_STATES: readonly ["received", "reviewing", "actioned", "counter_noticed"];
+/** The states a claim ends in. */
+export declare const CLOSED_CONTENT_CLAIM_STATES: readonly ["rejected", "reinstated", "upheld"];
+/**
+ * The kinds whose claimant asserts a right in a work or a mark. Only these
+ * carry the link to the original — a privacy or illegal-content report
+ * asserts no ownership.
+ */
+export declare function isRightsClaim(kind: ContentClaimKind): boolean;
+/**
+ * A request to erase the claimant's OWN personal data (GDPR art. 17): a
+ * privacy claim made by the person it is about. Oxy must answer it within one
+ * month (art. 12(3)); the claim carries that deadline.
+ */
+export declare function isErasureRequest(kind: ContentClaimKind, relationship: ClaimantRelationship): boolean;
+/** Days Oxy has to answer an erasure request ({@link isErasureRequest}). */
+export declare const ERASURE_REQUEST_DEADLINE_DAYS = 30;
+/**
+ * Stable error codes a takedown produces elsewhere in the API. A file whose
+ * bytes are on the blocklist cannot be uploaded, imported or copied by anyone
+ * (HTTP 451).
+ */
+export declare const CONTENT_CLAIM_ERROR_CODES: {
+    /** The submission failed validation; `fields` names each problem. */
+    readonly invalid: "CONTENT_CLAIM_INVALID";
+    /** These exact bytes were taken down after a claim and cannot be stored again. */
+    readonly contentBlocked: "CONTENT_BLOCKED";
+    /** A counter-notice failed validation; `fields` names each problem. */
+    readonly counterNoticeInvalid: "CONTENT_CLAIM_COUNTER_NOTICE_INVALID";
+    /** The files named are blocked by more than one claim: name the claim's reference. */
+    readonly counterNoticeAmbiguous: "CONTENT_CLAIM_COUNTER_NOTICE_AMBIGUOUS";
+    /** This account already sent a counter-notice for this claim. */
+    readonly counterNoticeExists: "CONTENT_CLAIM_COUNTER_NOTICE_EXISTS";
+};
+export type ContentClaimErrorCode = (typeof CONTENT_CLAIM_ERROR_CODES)[keyof typeof CONTENT_CLAIM_ERROR_CODES];
+/**
+ * A claim's reference as the claimant and the owner are sent it:
+ * `OXY-XXXX-XXXX`, Crockford base32 (no I, L, O or U).
+ */
+export declare const CONTENT_CLAIM_REFERENCE_PATTERN: RegExp;
+/** The bounds of an owner's counter-notice. The website fills its validation messages from these. */
+export declare const CONTENT_CLAIM_COUNTER_NOTICE_LIMITS: {
+    readonly maxFileIds: 50;
+    readonly maxFileId: 64;
+    readonly maxName: 200;
+    readonly maxAddress: 500;
+    readonly minPhone: 5;
+    readonly maxPhone: 40;
+    readonly maxEmail: 254;
+    readonly minMaterial: 10;
+    readonly maxMaterial: 2000;
+    readonly maxLocation: 2048;
+    readonly minExplanation: 20;
+    readonly maxExplanation: 5000;
+    readonly maxSignature: 200;
+};
+/**
+ * The statements an owner's counter-notice makes, word for word — what the
+ * form shows beside each box (17 U.S.C. § 512(g)(3)(C) and (D), and what Oxy
+ * does with the notice). The API records {@link COUNTER_NOTICE_STATEMENT_VERSION}
+ * with every notice, so the wording a person agreed to can always be told
+ * apart from a later one. Change the text only together with the version.
+ */
+export declare const COUNTER_NOTICE_STATEMENTS: {
+    readonly perjury: "I swear, under penalty of perjury, that I have a good faith belief that the material identified above was removed or disabled as a result of a mistake or misidentification of the material to be removed or disabled.";
+    readonly jurisdiction: "I consent to the jurisdiction of the Federal District Court for the judicial district in which my address is located or, if my address is outside of the United States, any judicial district in which Oxy may be found.";
+    readonly serviceOfProcess: "I will accept service of process from the person who provided the notification of the claimed infringement, or an agent of such person.";
+    readonly disclosure: "I understand that Oxy sends a copy of this counter-notice, including my name and contact details, to the person who made the claim, as the law requires.";
+};
+/** The version of {@link COUNTER_NOTICE_STATEMENTS} in force. */
+export declare const COUNTER_NOTICE_STATEMENT_VERSION = "2026-10-16";

package/dist/types/client/index.d.ts

@@ -27,7 +27,7 @@ export { SESSION_ACCOUNTS_CHANGED_EVENT, activeTokenCheck, deviceBackgroundCrede
 export { IDENTITY_LINK_QR_PREFIX, IDENTITY_LINK_STATUSES, buildIdentityLinkQrPayload, identityLinkCreateResponseCheck, identityLinkStateCheck, parseIdentityLinkQrPayload, } from './identityLink';
 export { IDENTITY_ERROR_CODES, IDENTITY_PROOF_ACTIONS, IDENTITY_PROOF_ACTION_VALUES, IDENTITY_PROOF_AUDIENCE, IDENTITY_PROOF_CHALLENGE_TTL_MS, IDENTITY_PROOF_DOMAIN, IDENTITY_PROOF_VERSION, buildIdentityProofMessage, canonicalJson, } from './identityProof';
 export { ORGANIZATION_ALIAS_KINDS, ORGANIZATION_CLAIM_DECISIONS, ORGANIZATION_CLAIM_STATUSES, ORGANIZATION_ERROR_CODES, ORGANIZATION_NAME_MAX_LENGTH, ORGANIZATION_STATUSES, ORGANIZATION_TYPES, createOrganizationCheck, organizationBatchCheck, organizationCheck, organizationClaimCheck, organizationClaimDetailCheck, organizationClaimInputCheck, organizationClaimListCheck, organizationClaimReviewCheck, organizationCurationResultCheck, organizationExternalCheck, organizationExternalResolutionCheck, organizationImportBatchResultCheck, organizationListCheck, organizationNameCheck, updateOrganizationCheck, } from './organizations';
-export { cancelProductSubscriptionCheck, personalPlanCatalogueCheck, personalPlanCheckoutRequestCheck, personalPlanCheckoutResultCheck, productSubscriptionCancellationResultCheck, productSubscriptionsResponseCheck, subjectProductAccessCheck, subjectProductAccessQueryCheck, subscriptionCreditGrantsResponseCheck, } from './products';
+export { cancelProductSubscriptionCheck, personalPlanCatalogueCheck, personalPlanCheckoutRequestCheck, personalPlanCheckoutResultCheck, productPlanCatalogueCheck, productPlanCheckoutRequestCheck, productSubscriptionCancellationResultCheck, productSubscriptionRenewalRequestCheck, productSubscriptionsResponseCheck, subjectProductAccessCheck, subjectProductAccessQueryCheck, subscriptionCreditGrantsResponseCheck, } from './products';
 export { recommendationRequestCheck } from './recommendations';
 export { isFullReputationBalance } from './reputation';
 export { PURCHASE_APPROVAL_STATUSES, SAFETY_POLICY_VERSION, SUPERVISED_ACTIONS, SUPERVISION_CONSENT_VERSION, SUPERVISION_INVITATION_STATUSES, SUPERVISION_STATUSES, profileAccessDecisionCheck, profileAccessInputCheck, purchaseApprovalCheck, purchaseApprovalListCheck, purchaseReviewInputCheck, safetyOrganizationsInputCheck, safetyOrganizationsResponseCheck, safetyPeopleInputCheck, safetyPeopleResponseCheck, supervisionAcceptInputCheck, supervisionContactInputCheck, supervisionContactsResponseCheck, supervisionInvitationCheck, supervisionInviteInputCheck, supervisionReviewInputCheck, supervisionStateCheck, } from './safety';
@@ -35,3 +35,4 @@ export { publicApplicationCheck } from './sessionStatus';
 export { EMAIL_ACCOUNTS_MAX, EMAIL_SIGNIN_CHOICE_TTL_MS, EMAIL_SIGNIN_LINK_TTL_MS, EMAIL_SIGNIN_LONG_CODE_ALPHABET, EMAIL_SIGNIN_LONG_CODE_LENGTH, PASSWORD_MAX_LENGTH, PASSWORD_MIN_LENGTH, REAUTH_ACTIONS, SIGNIN_SECOND_FACTOR_MAX_ATTEMPTS, SIGNIN_SECOND_FACTOR_TTL_MS, SIGN_IN_ERROR_CODES, TOTP_BACKUP_CODE_COUNT, TOTP_DIGITS, TOTP_PERIOD_SECONDS, emailSignInChooseAccountCheck, emailSignInLinkResponseCheck, emailSignInPendingCheck, emailSignInStartResponseCheck, isEmailSignInChooseAccount, isSecondFactorRequired, normalizeEmailSignInCode, reauthProofCheck, secondFactorRequiredCheck, signInMethodsCheck, totpBackupCodesResponseCheck, totpEnrollResponseCheck, } from './signIn';
 export { BOT_USERNAME_INVALID_MESSAGE, BOT_USERNAME_SUFFIX, NUMERIC_USERNAME_MESSAGE, RESERVED_USERNAMES, RESERVED_USERNAME_MESSAGE, USERNAME_INVALID_MESSAGE, USERNAME_MAX_LENGTH, USERNAME_MIN_LENGTH, USERNAME_PATTERN_SOURCE, applyBotUsernameSuffix, botUsernameCheck, stripDisallowedUsernameCharacters, usernameCheck, usernameCheckForAccountKind, } from './username';
 export { userNameCheck } from './userResponse';
+export { CLAIMANT_RELATIONSHIPS, CLOSED_CONTENT_CLAIM_STATES, CONTENT_CLAIM_COUNTER_NOTICE_LIMITS, CONTENT_CLAIM_ERROR_CODES, CONTENT_CLAIM_KINDS, CONTENT_CLAIM_LIMITS, CONTENT_CLAIM_REFERENCE_PATTERN, CONTENT_CLAIM_STATES, COUNTER_NOTICE_STATEMENT_VERSION, COUNTER_NOTICE_STATEMENTS, ERASURE_REQUEST_DEADLINE_DAYS, OPEN_CONTENT_CLAIM_STATES, isErasureRequest, isRightsClaim, } from './contentClaims';

package/dist/types/client/products.d.ts

@@ -4,12 +4,13 @@
  *
  * Part of `@oxy.so/contracts/client`: never import `zod` here (see `./check.ts`).
  */
-export declare const subjectProductAccessQueryCheck: import("./check").Check<{
+import { type Check } from './check';
+export declare const subjectProductAccessQueryCheck: Check<{
     schemaVersion: 1;
     subjectAccountId: string & import("zod").BRAND<"OxyAccountId">;
     productId: string;
 }>;
-export declare const subjectProductAccessCheck: import("./check").Check<{
+export declare const subjectProductAccessCheck: Check<{
     schemaVersion: 1;
     subjectAccountId: string & import("zod").BRAND<"OxyAccountId">;
     capabilities: {
@@ -31,10 +32,10 @@ export declare const subjectProductAccessCheck: import("./check").Check<{
         grantIds: string[];
     }[];
 }>;
-export declare const personalPlanCatalogueCheck: import("./check").Check<{
+export declare const personalPlanCatalogueCheck: Check<{
     schemaVersion: 1;
     state: "unconfigured" | "configured";
-    purchase: "unavailable";
+    purchase: "unavailable" | "available";
     plans: {
         kind: "oxy_one";
         displayName: string;
@@ -66,13 +67,44 @@ export declare const personalPlanCatalogueCheck: import("./check").Check<{
         } | undefined;
     }[];
 }>;
-export declare const personalPlanCheckoutRequestCheck: import("./check").Check<{
+export declare const productPlanCatalogueCheck: Check<{
+    schemaVersion: 1;
+    purchase: "unavailable" | "available";
+    productId: string;
+    plans: {
+        displayName: string;
+        price: {
+            currency: string;
+            amountMinorUnits: number;
+            interval: "year" | "month";
+            trial: "none";
+            taxTreatment: "inclusive";
+            merchantTotal: "final";
+        };
+        productId: string;
+        offerId: string;
+        offerVersion: number;
+    }[];
+}>;
+export declare const personalPlanCheckoutRequestCheck: Check<{
+    idempotencyKey: string;
+    offerId: string;
+    offerVersion: number;
+    expectedSubjectAccountId: string & import("zod").BRAND<"OxyAccountId">;
+}>;
+export declare const productPlanCheckoutRequestCheck: Check<{
     idempotencyKey: string;
+    productId: string;
     offerId: string;
     offerVersion: number;
     expectedSubjectAccountId: string & import("zod").BRAND<"OxyAccountId">;
 }>;
-export declare const personalPlanCheckoutResultCheck: import("./check").Check<{
+export declare const productSubscriptionRenewalRequestCheck: Check<{
+    sourceId: string;
+    idempotencyKey: string;
+    expectedSubjectAccountId: string & import("zod").BRAND<"OxyAccountId">;
+}>;
+export declare const personalPlanCheckoutResultCheck: Check<{
     reason: "provider_unconfigured" | "offer_unconfigured" | "price_unconfigured";
     state: "unconfigured";
 } | {
@@ -86,7 +118,7 @@ export declare const personalPlanCheckoutResultCheck: import("./check").Check<{
     state: "fulfilled";
     intentId: string;
 }>;
-export declare const productSubscriptionsResponseCheck: import("./check").Check<{
+export declare const productSubscriptionsResponseCheck: Check<{
     subscriptions: {
         status: "active" | "incomplete" | "canceled" | "incomplete_expired" | "past_due" | "paused" | "trialing" | "unpaid";
         sourceId: string;
@@ -112,9 +144,10 @@ export declare const productSubscriptionsResponseCheck: import("./check").Check<
                 displayName: string;
             }[];
         }[];
+        canRenew?: boolean | undefined;
     }[];
 }>;
-export declare const subscriptionCreditGrantsResponseCheck: import("./check").Check<{
+export declare const subscriptionCreditGrantsResponseCheck: Check<{
     grants: {
         createdAt: string;
         id: string;
@@ -131,12 +164,12 @@ export declare const subscriptionCreditGrantsResponseCheck: import("./check").Ch
         promotionId: string | null;
     }[];
 }>;
-export declare const cancelProductSubscriptionCheck: import("./check").Check<{
+export declare const cancelProductSubscriptionCheck: Check<{
     sourceId: string;
     actionId?: string | undefined;
     expectedSubjectAccountId?: (string & import("zod").BRAND<"OxyAccountId">) | undefined;
 }>;
-export declare const productSubscriptionCancellationResultCheck: import("./check").Check<{
+export declare const productSubscriptionCancellationResultCheck: Check<{
     sourceId: string;
     cancelAtPeriodEnd: true;
 } | {

package/dist/types/client/safety.d.ts

@@ -21,7 +21,7 @@ export declare const profileAccessInputCheck: Check<{
 }>;
 export declare const profileAccessDecisionCheck: Check<{
     allowed: boolean;
-    reason: "owner" | "unavailable" | "public" | "private" | "blocked";
+    reason: "owner" | "unavailable" | "blocked" | "private" | "public";
     policyVersion: "1";
 }>;
 export declare const supervisionInvitationCheck: Check<{

package/dist/types/contentClaims.d.ts

@@ -0,0 +1,383 @@
+/**
+ * Content claims (ADR 0043 D10): the public "Report content / rights claim"
+ * intake, `POST /content-claims`, and the staff review of a claim.
+ *
+ * {@link contentClaimSubmissionSchema} is the request body the API parses and
+ * the Oxy website validates its form with before posting, so the form cannot
+ * accept what the API would answer 400 to. Every validation message is a
+ * stable KEY under `contentClaim.errors.*` (filled with
+ * {@link CONTENT_CLAIM_LIMITS} by whoever shows it), never English: the website
+ * translates the key, and the API answers its own English sentence for it in
+ * `fields`.
+ */
+import { z } from 'zod';
+import { type ClaimantRelationship, type ContentClaimKind, type ContentClaimState } from './client/contentClaims';
+export { CLAIMANT_RELATIONSHIPS, CLOSED_CONTENT_CLAIM_STATES, CONTENT_CLAIM_COUNTER_NOTICE_LIMITS, CONTENT_CLAIM_ERROR_CODES, CONTENT_CLAIM_KINDS, CONTENT_CLAIM_LIMITS, CONTENT_CLAIM_REFERENCE_PATTERN, CONTENT_CLAIM_STATES, COUNTER_NOTICE_STATEMENT_VERSION, COUNTER_NOTICE_STATEMENTS, ERASURE_REQUEST_DEADLINE_DAYS, OPEN_CONTENT_CLAIM_STATES, isErasureRequest, isRightsClaim, } from './client/contentClaims';
+export type { ClaimantRelationship, ContentClaimErrorCode, ContentClaimKind, ContentClaimState, } from './client/contentClaims';
+/** Every key a submission's validation can produce, under `contentClaim.errors.*`. */
+export declare const CONTENT_CLAIM_VALIDATION_KEYS: readonly ["contentClaim.errors.kind", "contentClaim.errors.contentUrlsRequired", "contentClaim.errors.contentUrlsTooMany", "contentClaim.errors.contentUrlInvalid", "contentClaim.errors.descriptionShort", "contentClaim.errors.descriptionLong", "contentClaim.errors.originalWorkUrl", "contentClaim.errors.name", "contentClaim.errors.email", "contentClaim.errors.organization", "contentClaim.errors.relationship", "contentClaim.errors.goodFaith", "contentClaim.errors.accurate", "contentClaim.errors.signature"];
+export type ContentClaimValidationKey = (typeof CONTENT_CLAIM_VALIDATION_KEYS)[number];
+/**
+ * `POST /content-claims` — a claim, as the claimant sends it. Strict: an
+ * unknown key is refused rather than dropped.
+ */
+export declare const contentClaimSubmissionSchema: z.ZodObject<{
+    kind: z.ZodEnum<["copyright", "trademark", "privacy", "illegal_content", "other"]>;
+    contentUrls: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    description: z.ZodString;
+    originalWorkUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    claimant: z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodString;
+        organization: z.ZodOptional<z.ZodString>;
+        relationship: z.ZodEnum<["rights_holder", "authorized_agent", "affected_person", "other"]>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        email: string;
+        relationship: "other" | "rights_holder" | "authorized_agent" | "affected_person";
+        organization?: string | undefined;
+    }, {
+        name: string;
+        email: string;
+        relationship: "other" | "rights_holder" | "authorized_agent" | "affected_person";
+        organization?: string | undefined;
+    }>;
+    statements: z.ZodObject<{
+        goodFaith: z.ZodLiteral<true>;
+        accurate: z.ZodLiteral<true>;
+    }, "strict", z.ZodTypeAny, {
+        goodFaith: true;
+        accurate: true;
+    }, {
+        goodFaith: true;
+        accurate: true;
+    }>;
+    signature: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    kind: "other" | "copyright" | "trademark" | "privacy" | "illegal_content";
+    description: string;
+    signature: string;
+    contentUrls: string[];
+    claimant: {
+        name: string;
+        email: string;
+        relationship: "other" | "rights_holder" | "authorized_agent" | "affected_person";
+        organization?: string | undefined;
+    };
+    statements: {
+        goodFaith: true;
+        accurate: true;
+    };
+    originalWorkUrl?: string | undefined;
+}, {
+    kind: "other" | "copyright" | "trademark" | "privacy" | "illegal_content";
+    description: string;
+    signature: string;
+    contentUrls: string[];
+    claimant: {
+        name: string;
+        email: string;
+        relationship: "other" | "rights_holder" | "authorized_agent" | "affected_person";
+        organization?: string | undefined;
+    };
+    statements: {
+        goodFaith: true;
+        accurate: true;
+    };
+    originalWorkUrl?: string | undefined;
+}>;
+export type ContentClaimSubmission = z.infer<typeof contentClaimSubmissionSchema>;
+/** `201` to a submission: the claim's id and the reference the claimant quotes. */
+export interface ContentClaimSubmissionResponse {
+    id: string;
+    /** e.g. `OXY-7K3M-9Q2D`: what the claimant quotes when writing about the claim. */
+    reference: string;
+}
+/**
+ * `400` to a submission: `error` is a sentence for the person, and `fields`
+ * maps a body path (`claimant.email`, `contentUrls.3`) to a sentence about it.
+ */
+export interface ContentClaimSubmissionError {
+    error: string;
+    code: string;
+    fields?: Record<string, string>;
+}
+/** How a target's URL was understood. */
+export declare const CONTENT_CLAIM_TARGET_RESOLUTIONS: readonly ["file", "unresolved"];
+export type ContentClaimTargetResolution = (typeof CONTENT_CLAIM_TARGET_RESOLUTIONS)[number];
+/** Who added a target: the claimant's URL, or staff attaching a file by id. */
+export declare const CONTENT_CLAIM_TARGET_SOURCES: readonly ["claimant", "staff"];
+export type ContentClaimTargetSource = (typeof CONTENT_CLAIM_TARGET_SOURCES)[number];
+/** What the audit trail records. */
+export declare const CONTENT_CLAIM_EVENT_ACTIONS: readonly ["submitted", "review_started", "targets_attached", "targets_blocked", "rejected", "counter_notice_recorded", "counter_notice_submitted", "reinstated", "upheld", "note_added"];
+export type ContentClaimEventAction = (typeof CONTENT_CLAIM_EVENT_ACTIONS)[number];
+/** One target as staff see it. */
+export interface ContentClaimTargetView {
+    id: string;
+    source: ContentClaimTargetSource;
+    url: string | null;
+    resolution: ContentClaimTargetResolution;
+    /** The file this target names, when it names one (null after the file's owner was deleted). */
+    fileId: string | null;
+    sha256: string | null;
+    /** The file as it stands now, or null when there is no such row any more. */
+    file: {
+        id: string;
+        status: 'active' | 'trash' | 'blocked' | 'deleted';
+        visibility: 'private' | 'public' | 'unlisted';
+        mime: string;
+        size: number;
+        ownerKind: 'account' | 'application' | 'platform';
+        ownerUserId: string | null;
+        ownerApplicationId: string | null;
+    } | null;
+    blockedAt: string | null;
+    unblockedAt: string | null;
+    createdAt: string;
+}
+/** One audit entry. */
+export interface ContentClaimEventView {
+    id: string;
+    action: ContentClaimEventAction;
+    /** The staff member (or the signed-in claimant, for `submitted`); null when anonymous or deleted. */
+    actorUserId: string | null;
+    fromState: ContentClaimState | null;
+    toState: ContentClaimState | null;
+    /** Free text staff wrote (a rejection reason, a counter-notice summary, a note). */
+    note: string | null;
+    details: Record<string, unknown>;
+    createdAt: string;
+}
+/** A row of the queue. */
+export interface ContentClaimSummaryView {
+    id: string;
+    reference: string;
+    kind: ContentClaimKind;
+    relationship: ClaimantRelationship;
+    state: ContentClaimState;
+    /** The statutory deadline (an erasure request), or null. */
+    deadlineAt: string | null;
+    targetCount: number;
+    blockedTargetCount: number;
+    receivedAt: string;
+    updatedAt: string;
+    closedAt: string | null;
+}
+/** A claim in full, for its detail page. */
+export interface ContentClaimDetailView extends ContentClaimSummaryView {
+    submittedByUserId: string | null;
+    /** The claimant's statement; null once the retention period erased it. */
+    claimant: {
+        name: string;
+        email: string;
+        organization: string | null;
+        signature: string;
+        description: string;
+        originalWorkUrl: string | null;
+    } | null;
+    /** When the claimant's statement is erased (set when the claim closes). */
+    claimantExpiresAt: string | null;
+    targets: ContentClaimTargetView[];
+    events: ContentClaimEventView[];
+    /** The owners' own counter-notices, oldest first. */
+    counterNotices: ContentClaimCounterNoticeView[];
+}
+/** `GET /content-claims` */
+export interface ContentClaimListResponse {
+    claims: ContentClaimSummaryView[];
+    /** Pass as `cursor` for the next page; null on the last. */
+    nextCursor: string | null;
+}
+/** Every key a counter-notice's validation can produce, under `contentClaim.counterNotice.errors.*`. */
+export declare const CONTENT_CLAIM_COUNTER_NOTICE_VALIDATION_KEYS: readonly ["contentClaim.counterNotice.errors.claim", "contentClaim.counterNotice.errors.reference", "contentClaim.counterNotice.errors.claimId", "contentClaim.counterNotice.errors.fileIds", "contentClaim.counterNotice.errors.name", "contentClaim.counterNotice.errors.address", "contentClaim.counterNotice.errors.phone", "contentClaim.counterNotice.errors.email", "contentClaim.counterNotice.errors.materialDescription", "contentClaim.counterNotice.errors.materialLocation", "contentClaim.counterNotice.errors.explanation", "contentClaim.counterNotice.errors.perjury", "contentClaim.counterNotice.errors.jurisdiction", "contentClaim.counterNotice.errors.serviceOfProcess", "contentClaim.counterNotice.errors.disclosure", "contentClaim.counterNotice.errors.signature"];
+export type ContentClaimCounterNoticeValidationKey = (typeof CONTENT_CLAIM_COUNTER_NOTICE_VALIDATION_KEYS)[number];
+/**
+ * `POST /content-claims/counter-notices` — the owner of content a claim took
+ * down disputes it (17 U.S.C. § 512(g)(3)). Signed in: the API answers only
+ * for files the caller owns.
+ *
+ * Names the claim by its `reference` (the `OXY-XXXX-XXXX` the owner was
+ * emailed), its `claimId`, or the blocked `fileIds` — at least one. With
+ * `fileIds` the notice covers exactly those files; without, every one of the
+ * caller's files the claim blocked. Strict: an unknown key is refused.
+ */
+export declare const contentClaimCounterNoticeSchema: z.ZodEffects<z.ZodObject<{
+    reference: z.ZodOptional<z.ZodString>;
+    claimId: z.ZodOptional<z.ZodString>;
+    fileIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    subscriber: z.ZodObject<{
+        name: z.ZodString;
+        address: z.ZodString;
+        phone: z.ZodString;
+        email: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        email: string;
+        address: string;
+        phone: string;
+    }, {
+        name: string;
+        email: string;
+        address: string;
+        phone: string;
+    }>;
+    material: z.ZodObject<{
+        /** What was removed. */
+        description: z.ZodString;
+        /** Where it appeared before it was removed (a URL, or where in an app). */
+        location: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        description: string;
+        location: string;
+    }, {
+        description: string;
+        location: string;
+    }>;
+    /** Why it was a mistake or a misidentification, in the owner's words. */
+    explanation: z.ZodString;
+    /** Each of `COUNTER_NOTICE_STATEMENTS`, affirmed. */
+    statements: z.ZodObject<{
+        perjury: z.ZodLiteral<true>;
+        jurisdiction: z.ZodLiteral<true>;
+        serviceOfProcess: z.ZodLiteral<true>;
+        disclosure: z.ZodLiteral<true>;
+    }, "strict", z.ZodTypeAny, {
+        perjury: true;
+        jurisdiction: true;
+        serviceOfProcess: true;
+        disclosure: true;
+    }, {
+        perjury: true;
+        jurisdiction: true;
+        serviceOfProcess: true;
+        disclosure: true;
+    }>;
+    /** The owner's full legal name, typed as their signature. */
+    signature: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    signature: string;
+    statements: {
+        perjury: true;
+        jurisdiction: true;
+        serviceOfProcess: true;
+        disclosure: true;
+    };
+    subscriber: {
+        name: string;
+        email: string;
+        address: string;
+        phone: string;
+    };
+    material: {
+        description: string;
+        location: string;
+    };
+    explanation: string;
+    reference?: string | undefined;
+    claimId?: string | undefined;
+    fileIds?: string[] | undefined;
+}, {
+    signature: string;
+    statements: {
+        perjury: true;
+        jurisdiction: true;
+        serviceOfProcess: true;
+        disclosure: true;
+    };
+    subscriber: {
+        name: string;
+        email: string;
+        address: string;
+        phone: string;
+    };
+    material: {
+        description: string;
+        location: string;
+    };
+    explanation: string;
+    reference?: string | undefined;
+    claimId?: string | undefined;
+    fileIds?: string[] | undefined;
+}>, {
+    signature: string;
+    statements: {
+        perjury: true;
+        jurisdiction: true;
+        serviceOfProcess: true;
+        disclosure: true;
+    };
+    subscriber: {
+        name: string;
+        email: string;
+        address: string;
+        phone: string;
+    };
+    material: {
+        description: string;
+        location: string;
+    };
+    explanation: string;
+    reference?: string | undefined;
+    claimId?: string | undefined;
+    fileIds?: string[] | undefined;
+}, {
+    signature: string;
+    statements: {
+        perjury: true;
+        jurisdiction: true;
+        serviceOfProcess: true;
+        disclosure: true;
+    };
+    subscriber: {
+        name: string;
+        email: string;
+        address: string;
+        phone: string;
+    };
+    material: {
+        description: string;
+        location: string;
+    };
+    explanation: string;
+    reference?: string | undefined;
+    claimId?: string | undefined;
+    fileIds?: string[] | undefined;
+}>;
+export type ContentClaimCounterNotice = z.infer<typeof contentClaimCounterNoticeSchema>;
+/** `201` to a counter-notice. */
+export interface ContentClaimCounterNoticeResponse {
+    /** The counter-notice's id. */
+    id: string;
+    /** The claim it answers, as the owner was emailed it. */
+    reference: string;
+    /** Where the claim is now: `counter_noticed`. */
+    state: ContentClaimState;
+    /** The caller's blocked files the notice covers. */
+    fileIds: string[];
+}
+/**
+ * `400` to a counter-notice: `{ error, code: CONTENT_CLAIM_COUNTER_NOTICE_INVALID,
+ * fields }`, `fields` mapping each body path to a sentence.
+ */
+export type ContentClaimCounterNoticeError = ContentClaimSubmissionError;
+/** An owner's counter-notice as staff see it on the claim. */
+export interface ContentClaimCounterNoticeView {
+    id: string;
+    /** The account that sent it (null once that account is deleted). */
+    submittedByUserId: string | null;
+    fileIds: string[];
+    /** Which wording of `COUNTER_NOTICE_STATEMENTS` was affirmed. */
+    statementVersion: string;
+    /** What the owner wrote; null once the retention period erased it. */
+    statement: {
+        name: string;
+        address: string;
+        phone: string;
+        email: string;
+        materialDescription: string;
+        materialLocation: string;
+        explanation: string;
+        signature: string;
+    } | null;
+    createdAt: string;
+}

package/dist/types/email/messages.d.ts

@@ -761,9 +761,9 @@ export declare const emailFilterSchema: z.ZodObject<{
     id: string;
     enabled: boolean;
     userId: string;
+    matchAll: boolean;
     _id: string;
     order: number;
-    matchAll: boolean;
     conditions: {
         value: string;
         field: "subject" | "from" | "size" | "to" | "has-attachment";
@@ -780,9 +780,9 @@ export declare const emailFilterSchema: z.ZodObject<{
     id: string;
     enabled: boolean;
     userId: string;
+    matchAll: boolean;
     _id: string;
     order: number;
-    matchAll: boolean;
     conditions: {
         value: string;
         field: "subject" | "from" | "size" | "to" | "has-attachment";