@vimine/sdk 0.2.0

package/dist/errors.js

@@ -0,0 +1,50 @@
+// One error type for everything the API can say no to. `code` is the stable identifier to branch on: the
+// `code` of an RFC 9457 problem document, the `error` of an OAuth error body, or one of the SDK's own
+// (`network`, `state_mismatch`, `not_signed_in`, `framed`, `no_flow`).
+export class VimineError extends Error {
+    code;
+    status;
+    requestId;
+    detail;
+    errors;
+    cause;
+    constructor(code, message, opts = {}) {
+        super(message);
+        this.name = 'VimineError';
+        this.code = code;
+        this.status = opts.status ?? null;
+        this.requestId = opts.requestId ?? null;
+        this.detail = opts.detail ?? null;
+        this.errors = opts.errors;
+        if (opts.cause !== undefined)
+            this.cause = opts.cause;
+    }
+    /** True for the errors that mean "the session is gone: sign in again". */
+    get isAuthError() {
+        return this.status === 401 || ['invalid_token', 'token_expired', 'missing_token', 'invalid_grant', 'not_signed_in'].includes(this.code);
+    }
+    static fromProblem(body, status) {
+        const code = typeof body.code === 'string' && body.code ? body.code : `http_${status}`;
+        return new VimineError(code, body.detail || body.title || `HTTP ${status}`, { status, requestId: body.request_id ?? null, detail: body.detail ?? null, errors: body.errors });
+    }
+    static fromOAuth(body, status) {
+        return new VimineError(body.error || `http_${status}`, body.error_description || body.error || `HTTP ${status}`, { status });
+    }
+    static async fromResponse(res) {
+        let body = null;
+        try {
+            body = await res.json();
+        }
+        catch {
+            /* non-JSON body */
+        }
+        if (body && typeof body === 'object') {
+            const b = body;
+            if (typeof b.error === 'string')
+                return VimineError.fromOAuth(b, res.status);
+            return VimineError.fromProblem(b, res.status);
+        }
+        return new VimineError(`http_${res.status}`, `HTTP ${res.status}`, { status: res.status });
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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","sourcesContent":["// One error type for everything the API can say no to. `code` is the stable identifier to branch on: the\n// `code` of an RFC 9457 problem document, the `error` of an OAuth error body, or one of the SDK's own\n// (`network`, `state_mismatch`, `not_signed_in`, `framed`, `no_flow`).\n\nimport type { FiscalCodeHint, FiscalCodeMismatch } from './types.js';\n\n/**\n * One entry of a problem's `errors[]`: the field and what is wrong with it. A `codicefiscale_mismatch` entry also says\n * what disagrees with the code and whether the person may confirm it (resend with `codicefiscale_confirmed: true`).\n */\nexport interface FieldError {\n    field?: string;\n    code?: string;\n    message?: string;\n    /** `codicefiscale_mismatch`: what disagrees with the code (never `gender`: it is not cross-checked there). */\n    mismatches?: FiscalCodeMismatch[];\n    /** `codicefiscale_mismatch`: `names_swapped` when the code matches once surname and given name are exchanged. */\n    hints?: FiscalCodeHint[];\n    /** `codicefiscale_mismatch`: `false` when both names and the date disagree — nothing ties the code to the person. */\n    confirmable?: boolean;\n    [k: string]: unknown;\n}\n\nexport interface ProblemDetails {\n    type?: string;\n    title?: string;\n    status?: number;\n    code?: string;\n    detail?: string;\n    request_id?: string;\n    errors?: FieldError[];\n    [k: string]: unknown;\n}\n\nexport interface OAuthErrorBody {\n    error: string;\n    error_description?: string;\n}\n\nexport class VimineError extends Error {\n    readonly code: string;\n    readonly status: number | null;\n    readonly requestId: string | null;\n    readonly detail: string | null;\n    readonly errors: ProblemDetails['errors'];\n    override readonly cause?: unknown;\n\n    constructor(code: string, message: string, opts: { status?: number | null; requestId?: string | null; detail?: string | null; errors?: ProblemDetails['errors']; cause?: unknown } = {}) {\n        super(message);\n        this.name = 'VimineError';\n        this.code = code;\n        this.status = opts.status ?? null;\n        this.requestId = opts.requestId ?? null;\n        this.detail = opts.detail ?? null;\n        this.errors = opts.errors;\n        if (opts.cause !== undefined) this.cause = opts.cause;\n    }\n\n    /** True for the errors that mean \"the session is gone: sign in again\". */\n    get isAuthError(): boolean {\n        return this.status === 401 || ['invalid_token', 'token_expired', 'missing_token', 'invalid_grant', 'not_signed_in'].includes(this.code);\n    }\n\n    static fromProblem(body: ProblemDetails, status: number): VimineError {\n        const code = typeof body.code === 'string' && body.code ? body.code : `http_${status}`;\n        return new VimineError(code, body.detail || body.title || `HTTP ${status}`, { status, requestId: body.request_id ?? null, detail: body.detail ?? null, errors: body.errors });\n    }\n\n    static fromOAuth(body: OAuthErrorBody, status: number): VimineError {\n        return new VimineError(body.error || `http_${status}`, body.error_description || body.error || `HTTP ${status}`, { status });\n    }\n\n    static async fromResponse(res: Response): Promise<VimineError> {\n        let body: unknown = null;\n        try {\n            body = await res.json();\n        } catch {\n            /* non-JSON body */\n        }\n        if (body && typeof body === 'object') {\n            const b = body as Record<string, unknown>;\n            if (typeof b.error === 'string') return VimineError.fromOAuth(b as unknown as OAuthErrorBody, res.status);\n            return VimineError.fromProblem(b as ProblemDetails, res.status);\n        }\n        return new VimineError(`http_${res.status}`, `HTTP ${res.status}`, { status: res.status });\n    }\n}\n"]}

package/dist/generated.d.ts

@@ -0,0 +1,557 @@
+export interface Problem {
+    type: string;
+    title: string;
+    status: number;
+    detail?: string;
+    code: string;
+    request_id?: string;
+    errors?: Array<{
+        field?: string;
+        code?: string;
+        message?: string;
+    }>;
+}
+export interface Verification {
+    status: "active" | "inactive";
+    valid_until?: string;
+    /** With `reason: not_yet_valid`: the card is genuine and active, and becomes usable at this moment */
+    valid_from?: string;
+    reason?: "expired" | "invalid" | "not_yet_valid";
+    /** Present for registration tokens */
+    kind?: "card" | "registration";
+    event?: {
+        slug?: string;
+        starts_at?: string;
+    } | null;
+}
+export interface MembershipType {
+    uid?: string;
+    cod?: string;
+    name?: string;
+    description?: string | null;
+    quota_amount?: number | null;
+    currency?: string;
+    expiry_model?: "solar_year" | "rolling_12" | "rolling_24" | "prorated_solar" | "custom";
+    network_eligible?: boolean;
+}
+export interface Statuto {
+    uid?: string;
+    version?: number;
+    approvaldate?: string | null;
+    sha256?: string | null;
+    content?: string | null;
+    document_url?: string | null;
+}
+export interface ApsPublicConfig {
+    /** The language this answer is written in */
+    locale?: string;
+    /** The languages the association offers: its own, plus those it enabled */
+    locales?: Array<string>;
+    aps: {
+        slug?: string;
+        name?: string;
+        brandcolor?: string | null;
+        picture_url?: string | null;
+        citta?: string | null;
+        provincia?: string | null;
+        enroll_enabled?: boolean;
+        /** How the association admits its members, so that an applicant can be told up front what to expect. `model`: `board` — the request waits for a decision of the association’s board, and any fee is paid after it; `provisional` — admitted at once, ratified by the board later; `automatic` — active as soon as the conditions are met. `delay_hours`: the hours between admission and a USABLE card (0 = at once): the membership is active from admission, the card counts at the door only afterwards (see `valid_from`). */
+        admission?: {
+            model?: "board" | "provisional" | "automatic";
+            delay_hours?: number;
+        };
+        /** Kept for compatibility: true when `admission.model` is `board`. Read `admission` instead. */
+        approval_required?: boolean;
+        /** Whether the association collects its members’ address — of every member or of nobody. `none`: do not ask (an `address` sent anyway is not stored); `optional`; `required`: enrolment answers 422 without one. */
+        member_address?: "none" | "optional" | "required";
+        /** How to pay the fee, as the association words it */
+        payment_instructions?: string | null;
+        /** The activities of general interest the association carries out (Italian Third Sector Code, art. 5): `cod` is the letter of the article, `description` its Italian wording; one is marked as prevalent. */
+        activity_sectors?: Array<{
+            cod?: string;
+            description?: string;
+            prevalent?: boolean;
+        }>;
+        /** Present when the association is registered in the RUNTS (the Italian national register of Third Sector entities), as checked by the platform against the official public lists; null otherwise. Never typed by the association. */
+        registry?: {
+            /** Section of the register */
+            section?: "APS" | "ODV" | "EF" | "IS" | "RA" | "SOMS" | "ALTRI" | null | null;
+            /** Repertory number */
+            number?: string | null;
+            registered_on?: string | null;
+            /** Date of the official list the check ran against */
+            checked_on?: string | null;
+        } | null;
+    };
+    membership_types: Array<MembershipType>;
+    statuto: Statuto | unknown;
+    /** The association's in-force privacy notice to members (full text: GET /v1/aps/{slug}/privacy-notice) */
+    privacy_notice?: PrivacyNoticeRef | unknown;
+}
+export interface FiscalCodeCheck {
+    /** Codice fiscale (16 characters) */
+    code: string;
+    first_name?: string;
+    last_name?: string;
+    gender?: "M" | "F";
+    /** Date of birth */
+    date?: string;
+    /** Birthplace: the comune, for a person born in Italy */
+    place?: string;
+    /** Birth country, ISO 3166-1 alpha-2. A code encodes the comune for people born in Italy and only the STATE for everybody else: anything but IT is compared with that state and `place` is ignored */
+    country?: string;
+}
+export interface FiscalCodeResult {
+    valid?: boolean;
+    error?: "invalid" | "mismatch" | null;
+    /** What disagrees with the code, when `error` is `mismatch` */
+    mismatches?: Array<"lastName" | "firstName" | "gender" | "date" | "place">;
+    /** `names_swapped`: the code matches once surname and given name are exchanged */
+    hints?: Array<"names_swapped">;
+    /** The date of birth the code itself encodes */
+    birth_date?: string | null;
+    /** The birth country the code itself encodes, ISO 3166-1 alpha-2 (IT for a comune) */
+    birth_country?: string | null;
+}
+export interface CardKeys {
+    keys?: Array<{
+        kty?: string;
+        crv?: string;
+        x?: string;
+        kid?: string;
+        use?: string;
+        alg?: string;
+    }>;
+}
+export interface SignupRequest {
+    email: string;
+    first_name: string;
+    last_name: string;
+    phone?: string | null;
+    dob?: string | null;
+    /** Demographic only: it is not cross-checked */
+    gender?: "M" | "F" | null;
+    /** Comune (born in Italy) or city, free text (born abroad) */
+    birthplace?: string | null;
+    /** ISO 3166-1 alpha-2 */
+    birth_country?: string | null;
+    /** Validated and cross-checked against the other fields when present */
+    codicefiscale?: string | null;
+    /** The person confirms a code that disagrees with their particulars (422 `codicefiscale_mismatch` with `confirmable: true`) */
+    codicefiscale_confirmed?: boolean;
+    /** The language of the page the person filled in (`it`, `en`; a regional tag such as `en-GB` is reduced to its language). It decides the language of the mails that follow and becomes the preference of a NEW account; an existing account keeps its own. Unsupported values are ignored */
+    locale?: string | null;
+    /** The account terms (platform_terms) the person accepted on your site — optional, but when given it must name the in-force version */
+    accept_terms?: LegalRef;
+    /** The platform privacy notice (platform_privacy) the person read on your site — optional, same rule */
+    acknowledge_privacy?: LegalRef;
+}
+export interface EnrollRequest {
+    email: string;
+    first_name: string;
+    last_name: string;
+    /** Optional. A person is identified by a fiscal code OR by `dob` + `birthplace` + `birth_country` — never neither (422 `required` on each missing particular). When present it is validated and cross-checked against the names, the date and the place (the state, for people born abroad) */
+    codicefiscale?: string | null;
+    /** The person confirms a code that disagrees with their particulars (422 `codicefiscale_mismatch` with `confirmable: true`) */
+    codicefiscale_confirmed?: boolean;
+    /** Residence or, where different, domicile. Asked of every member or of nobody: the public profile says what the association declared (`member_address`: none — ignored, not stored · optional · required — 422 `required` on `address` without it) */
+    address?: MemberAddress;
+    phone?: string | null;
+    dob?: string | null;
+    /** Demographic only: it is not cross-checked */
+    gender?: "M" | "F" | null;
+    /** Comune (born in Italy) or city, free text (born abroad) */
+    birthplace?: string | null;
+    /** ISO 3166-1 alpha-2 */
+    birth_country?: string | null;
+    /** One of the association’s membership types (omit when it has exactly one) */
+    membership_type?: string;
+    /** The language of the page the person filled in (`it`, `en`; a regional tag such as `en-GB` is reduced to its language). It decides the language of the mails that follow and becomes the preference of a NEW account; an existing account keeps its own. Unsupported values are ignored */
+    locale?: string | null;
+    /** The in-force statuto the person accepted on your site (from GET /v1/aps/{slug}) */
+    accept_statuto: {
+        version: number;
+        sha256?: string;
+    };
+    /** The association's privacy notice the person read on your site (GET /v1/aps/{slug} → privacy_notice). REQUIRED when the association publishes one; 422 `privacy_notice_outdated` when it is not the in-force version */
+    privacy_notice?: PrivacyNoticeAck;
+    /** The account terms (platform_terms) the person accepted on your site — optional, must name the in-force version */
+    accept_terms?: LegalRef;
+    /** The platform privacy notice (platform_privacy) the person read — optional, same rule */
+    acknowledge_privacy?: LegalRef;
+}
+export interface Accepted {
+    status: "accepted";
+}
+export interface Me {
+    /** The subject identifier of this person, as in the ID token */
+    sub: string;
+    email: string;
+    email_verified: boolean;
+    first_name?: string | null;
+    last_name?: string | null;
+    phone?: string | null;
+    dob?: string | null;
+    /** Demographic only */
+    gender?: "M" | "F" | null;
+    birthplace?: string | null;
+    /** ISO 3166-1 alpha-2 */
+    birth_country?: string | null;
+    /** Optional: a person may have none */
+    codicefiscale?: string | null;
+    /** How the person is identified. `matched`: a fiscal code that agrees with their particulars; `mismatch_confirmed`: a code that disagrees, confirmed by the person; `absent`: no code — date, place and country of birth identify them; null: not identified yet (they cannot request a membership) */
+    codicefiscale_check?: "matched" | "mismatch_confirmed" | "absent" | null;
+    /** The language the person chose for the platform and its mails; null: never chosen — the language of the request, then of the association, applies */
+    locale?: "it" | "en" | null;
+    updated_at?: string | null;
+}
+export interface MemberAddress {
+    kind?: "residence" | "domicile";
+    /** Street and number */
+    line: string;
+    postal_code?: string | null;
+    city: string;
+    /** Italian addresses only (two letters); dropped abroad */
+    province?: string | null;
+    /** ISO 3166-1 alpha-2 */
+    country?: string;
+}
+export interface EnrollConfirmRequest {
+    token: string;
+    /** Only after a 409 `identification_required`: what the account still lacks — a fiscal code, or date, place and country of birth. Completes the EMPTY fields of the profile, never over what is there */
+    identification?: {
+        dob?: string;
+        birthplace?: string;
+        birth_country?: string;
+        codicefiscale?: string;
+        codicefiscale_confirmed?: boolean;
+    };
+}
+export interface Event {
+    id?: string;
+    slug?: string;
+    /** The language the `title` was served in. When it is not the one you asked for, the association has no translation: you got its Italian text, not a machine translation */
+    locale?: string;
+    /** The languages in which this event has a title — the association’s own always, plus those it enabled and wrote */
+    locales?: Array<string>;
+    title?: string;
+    summary?: string | null;
+    /** Markdown; render it yourself */
+    description_md?: string | null;
+    starts_at?: string;
+    ends_at?: string | null;
+    timezone?: string;
+    status?: "published" | "completed" | "cancelled";
+    visibility?: "members_only" | "public";
+    location?: {
+        name?: string | null;
+        address?: string | null;
+        lat?: number | null;
+        lng?: number | null;
+    } | null;
+    cover_url?: string | null;
+    gallery?: Array<{
+        url?: string;
+        alt?: string | null;
+        order?: number;
+    }>;
+    links?: Array<{
+        label?: string;
+        url?: string;
+    }>;
+    registration?: {
+        opens_at?: string | null;
+        closes_at?: string | null;
+        capacity?: number | null;
+        remaining?: number | null;
+        cancellation_hours?: number;
+    };
+    registration_types?: Array<{
+        uid?: string;
+        cod?: string;
+        name?: string;
+        description?: string | null;
+        /** 0 = free */
+        amount?: number;
+        currency?: string;
+        quantity?: number | null;
+        /** Places left (never who holds them) */
+        remaining?: number | null;
+        max_per_user?: number;
+        requires_active_membership?: boolean;
+        open?: boolean;
+        reason?: "sold_out" | "registration_not_open" | "registration_closed" | null | null;
+        opens_at?: string | null;
+        closes_at?: string | null;
+    }>;
+    published_at?: string | null;
+    cancelled_at?: string | null;
+    cancel_reason?: string | null;
+}
+export interface Registration {
+    id?: string;
+    status?: "reserved" | "confirmed" | "cancelled" | "refunded";
+    event?: {
+        id?: string;
+        slug?: string;
+        title?: string;
+        starts_at?: string;
+        ends_at?: string | null;
+        timezone?: string;
+        status?: string;
+        location?: string | null;
+    };
+    registration_type?: {
+        uid?: string;
+        cod?: string;
+        name?: string;
+        amount?: number;
+        currency?: string;
+    };
+    quantity?: number;
+    reserved_until?: string | null;
+    checked_in_at?: string | null;
+    cancelled_at?: string | null;
+    cancel_reason?: string | null;
+    can_cancel?: boolean;
+    payment?: {
+        status?: string;
+        amount?: number;
+        currency?: string;
+        method?: string;
+        paid_at?: string;
+    } | null;
+    /** How to pay the contribution while reserved */
+    payment_instructions?: string | null;
+    /** Free text the person wrote. Withheld (null) from third-party clients when the association declared it processes special categories of data */
+    note?: string | null;
+    created_at?: string;
+    /** The registration QR payload (vmt_…), confirmed registrations only */
+    token?: string | null;
+}
+export interface Eligibility {
+    can_register?: boolean;
+    membership_verdict?: string | null;
+    types?: Array<{
+        uid?: string;
+        cod?: string;
+        can_register?: boolean;
+        reasons?: Array<string>;
+        pending_membership?: boolean;
+    }>;
+}
+export interface RegistrationRequest {
+    registration_type: string;
+    note?: string | null;
+    quantity?: number;
+    /** The language the registration was made in (`it`, `en`): the language of the mails to a guest, and the fallback for a member who never chose one. Defaults to Accept-Language */
+    locale?: string | null;
+}
+export interface GuestRegistrationRequest {
+    email: string;
+    first_name: string;
+    last_name: string;
+    registration_type: string;
+    note?: string | null;
+    /** The language the registration was made in (`it`, `en`): the language of the mails to a guest, and the fallback for a member who never chose one. Defaults to Accept-Language */
+    locale?: string | null;
+}
+export interface RegistrationListItem {
+    id?: string;
+    status?: string;
+    registration_type?: string | null;
+    membership_id?: string | null;
+    quantity?: number;
+    checked_in_at?: string | null;
+    created_at?: string;
+}
+export interface LegalDocumentSummary {
+    uid?: string;
+    /** Document kind (platform_terms, platform_privacy, platform_cookie, aps_terms, aps_dpa, aps_dpa_annex1_processing … developer_terms) */
+    kind: string;
+    locale: "it" | "en";
+    /** Version label (1.0, 1.1, …) */
+    version: string;
+    title: string;
+    /** What changed in this version */
+    summary?: string | null;
+    effective_from?: string | null;
+    retired_at?: string | null;
+    /** SHA-256 of the canonical template body */
+    sha256?: string | null;
+    /** This is the in-force version of the kind in its locale */
+    current: boolean;
+    requires_reacceptance?: boolean;
+}
+export interface LegalDocumentList {
+    documents: Array<LegalDocumentSummary>;
+    /** Previous versions (with ?all=1) */
+    archive?: Array<LegalDocumentSummary>;
+}
+export type LegalDocument = unknown;
+export interface SubProcessor {
+    cod: string;
+    name: string;
+    entity?: string | null;
+    service: string;
+    data_categories?: string | null;
+    location?: string | null;
+    transfer_basis?: string | null;
+    role: "processor" | "controller" | "none";
+    status: "active" | "planned" | "retired";
+    since?: string | null;
+    until?: string | null;
+    website?: string | null;
+}
+export interface SubProcessorRegistry {
+    /** The in-force Annex 3 version the registry is bound to */
+    version?: string | null;
+    effective_from?: string | null;
+    notice_days?: number;
+    at?: string;
+    active: Array<SubProcessor>;
+    planned: Array<SubProcessor>;
+    /** Vendors that process no tenant data (transparency) */
+    other: Array<SubProcessor>;
+}
+export interface PrivacyNoticeRef {
+    uid: string;
+    version: number;
+    locale: string;
+    title?: string;
+    sha256?: string | null;
+    effective_from?: string | null;
+}
+export type PrivacyNotice = unknown;
+export interface LegalRef {
+    /** The in-force version label shown (GET /v1/legal/{kind}) */
+    version: string;
+    /** Its template hash, when published */
+    sha256?: string;
+}
+export interface PrivacyNoticeAck {
+    /** The in-force notice version shown (GET /v1/aps/{slug} → privacy_notice) */
+    version: number;
+    sha256?: string;
+    /** The language of the notice you showed (`privacy_notice.locale` of the answer you read it from). Each language is its own document, with its own version: name it when you read the profile with `?locale=`. Default: the request’s `locale`, then the association’s language */
+    locale?: string;
+}
+export interface AcceptanceRecord {
+    at: string;
+    action: "accepted" | "acknowledged" | "consented" | "withdrawn" | "declared";
+    channel?: "ui" | "public" | "api" | "job" | "paper";
+    kind: string;
+    title?: string;
+    version: string;
+    sha256?: string | null;
+    /** Hash of the text actually shown */
+    rendered_sha256?: string | null;
+    locale?: string | null;
+    /** The association the act concerns, when any */
+    association?: string | null;
+}
+export interface PendingDocument {
+    kind: string;
+    title?: string;
+    locale?: string;
+    version: string | number;
+    sha256?: string | null;
+    effective_from?: string | null;
+    /** What the person is asked to do */
+    action: "accepted" | "acknowledged" | "consented";
+    /** Never acted on any version of this kind (false: a new version requires it again) */
+    first?: boolean;
+}
+export interface MyAcceptances {
+    items: Array<AcceptanceRecord>;
+    pending: {
+        /** Account-layer documents still to accept / acknowledge */
+        platform?: Array<PendingDocument>;
+        /** This association's notice to members, when not yet acknowledged */
+        privacy_notice?: PendingDocument | unknown;
+    };
+}
+export interface AcceptanceRequest {
+    /** platform_terms | platform_privacy | network_consent | privacy_notice */
+    kind: string;
+    /** The in-force version shown */
+    version: string | number;
+    sha256?: string;
+}
+export interface AcceptanceResult {
+    recorded: boolean;
+    kind: string;
+    action: string;
+    version: string;
+    at: string;
+}
+export interface EnrollConfirmResult {
+    status: "pending" | "active" | "suspended" | "revoked" | "rejected";
+    /** The person already had a membership request or membership here */
+    already: boolean;
+    /** Why the membership is still pending, in order: the association’s approval first (when it admits by decision of its board), then the fee. Empty when active */
+    pending_reasons?: Array<"approval" | "payment">;
+    /** May the fee be paid yet? False while the approval is pending: approval opens payment */
+    payment_open?: boolean;
+    /** When the card becomes usable, for an active membership inside the association’s usability delay; null otherwise */
+    valid_from?: string | null;
+    association: {
+        name?: string;
+        slug?: string;
+    };
+}
+/** Every operation of the document: id → [method, path]. */
+export declare const operations: {
+    readonly getOpenApi: readonly ["GET", "/v1/openapi.json"];
+    readonly getCardKeys: readonly ["GET", "/v1/card-keys"];
+    readonly getApsPublicConfig: readonly ["GET", "/v1/aps/{slug}"];
+    readonly verifyCard: readonly ["GET", "/v1/verify/{card_token}"];
+    readonly validateFiscalCode: readonly ["POST", "/v1/validate/fiscal-code"];
+    readonly oauthToken: readonly ["POST", "/v1/oauth/token"];
+    readonly oauthRevoke: readonly ["POST", "/v1/oauth/revoke"];
+    readonly oauthClientInfo: readonly ["GET", "/v1/oauth/client-info"];
+    readonly getMe: readonly ["GET", "/v1/me"];
+    readonly closeMe: readonly ["DELETE", "/v1/me"];
+    readonly updateMe: readonly ["PATCH", "/v1/me"];
+    readonly exportMe: readonly ["GET", "/v1/me/export"];
+    readonly getMyMembership: readonly ["GET", "/v1/me/membership"];
+    readonly requestMyMembership: readonly ["POST", "/v1/me/membership"];
+    readonly renewMyMembership: readonly ["POST", "/v1/me/membership/renew"];
+    readonly setNetworkOptIn: readonly ["PATCH", "/v1/me/membership/network-opt-in"];
+    readonly getMyCardImage: readonly ["GET", "/v1/me/membership/card.svg"];
+    readonly emailMyCard: readonly ["POST", "/v1/me/membership/card/email"];
+    readonly getGoogleWalletLink: readonly ["GET", "/v1/me/membership/wallet/google"];
+    readonly getMyMembershipEvents: readonly ["GET", "/v1/me/membership/events"];
+    readonly getMyStatuto: readonly ["GET", "/v1/me/membership/statuto"];
+    readonly acceptMyStatuto: readonly ["POST", "/v1/me/membership/statuto/accept"];
+    readonly getMyAcceptances: readonly ["GET", "/v1/me/acceptances"];
+    readonly recordMyAcceptance: readonly ["POST", "/v1/me/acceptances"];
+    readonly getMyCard: readonly ["GET", "/v1/me/membership/card"];
+    readonly getMyConnections: readonly ["GET", "/v1/me/connections"];
+    readonly revokeMyConnection: readonly ["DELETE", "/v1/me/connections/{client_id}"];
+    readonly listMemberships: readonly ["GET", "/v1/memberships"];
+    readonly getMembershipStatus: readonly ["GET", "/v1/memberships/{id}/status"];
+    readonly getSandbox: readonly ["GET", "/v1/sandbox"];
+    readonly resetSandbox: readonly ["POST", "/v1/sandbox/reset"];
+    readonly signup: readonly ["POST", "/v1/signup"];
+    readonly enroll: readonly ["POST", "/v1/enroll"];
+    readonly confirmEnrollment: readonly ["POST", "/v1/enroll/confirm"];
+    readonly createCheckin: readonly ["POST", "/v1/checkins"];
+    readonly listPublicEvents: readonly ["GET", "/v1/aps/{slug}/events"];
+    readonly getPublicEvent: readonly ["GET", "/v1/aps/{slug}/events/{event}"];
+    readonly listEvents: readonly ["GET", "/v1/events"];
+    readonly getEvent: readonly ["GET", "/v1/events/{slug}"];
+    readonly getEventEligibility: readonly ["GET", "/v1/events/{slug}/eligibility"];
+    readonly createRegistration: readonly ["POST", "/v1/events/{slug}/registrations"];
+    readonly listEventRegistrations: readonly ["GET", "/v1/events/{slug}/registrations"];
+    readonly listMyRegistrations: readonly ["GET", "/v1/me/registrations"];
+    readonly getMyRegistration: readonly ["GET", "/v1/me/registrations/{id}"];
+    readonly cancelMyRegistration: readonly ["DELETE", "/v1/me/registrations/{id}"];
+    readonly createGuestRegistration: readonly ["POST", "/v1/events/{slug}/registrations/guest"];
+    readonly confirmGuestRegistration: readonly ["POST", "/v1/registrations/confirm"];
+    readonly listLegalDocuments: readonly ["GET", "/v1/legal"];
+    readonly getSubProcessors: readonly ["GET", "/v1/legal/sub-processors"];
+    readonly getLegalDocument: readonly ["GET", "/v1/legal/{kind}"];
+    readonly getApsPrivacyNotice: readonly ["GET", "/v1/aps/{slug}/privacy-notice"];
+};
+export type OperationId = keyof typeof operations;