@versedbcom/sdk 0.1.1

package/src/models/operations/add-issue-to-collection.ts

@@ -0,0 +1,655 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
+
+/**
+ * Physical format of the copy.
+ */
+export const AddIssueToCollectionFormat = {
+  Standard: "standard",
+  TradePaperback: "trade_paperback",
+  Hardcover: "hardcover",
+  Omnibus: "omnibus",
+  DeluxeEdition: "deluxe_edition",
+  Annual: "annual",
+  GraphicNovel: "graphic_novel",
+  Digital: "digital",
+  Treasury: "treasury",
+  Magazine: "magazine",
+  Prestige: "prestige",
+  Digest: "digest",
+  Other: "other",
+} as const;
+/**
+ * Physical format of the copy.
+ */
+export type AddIssueToCollectionFormat = ClosedEnum<
+  typeof AddIssueToCollectionFormat
+>;
+
+/**
+ * Where the comic was purchased.
+ */
+export const AddIssueToCollectionPurchaseSource = {
+  ComicShop: "comic_shop",
+  OnlineRetailer: "online_retailer",
+  Auction: "auction",
+  Convention: "convention",
+  PrivateSeller: "private_seller",
+  Subscription: "subscription",
+  DigitalPlatform: "digital_platform",
+  SecondHandStore: "second_hand_store",
+  Inheritance: "inheritance",
+  Gift: "gift",
+  Trade: "trade",
+  Other: "other",
+} as const;
+/**
+ * Where the comic was purchased.
+ */
+export type AddIssueToCollectionPurchaseSource = ClosedEnum<
+  typeof AddIssueToCollectionPurchaseSource
+>;
+
+/**
+ * How the comic was acquired.
+ */
+export const AddIssueToCollectionAcquisitionMethod = {
+  Purchase: "purchase",
+  Trade: "trade",
+  Gift: "gift",
+  Inheritance: "inheritance",
+  Subscription: "subscription",
+  Found: "found",
+  Other: "other",
+} as const;
+/**
+ * How the comic was acquired.
+ */
+export type AddIssueToCollectionAcquisitionMethod = ClosedEnum<
+  typeof AddIssueToCollectionAcquisitionMethod
+>;
+
+export const AddIssueToCollectionVariantType = {
+  Standard: "standard",
+  CoverVariant: "cover_variant",
+  RetailerExclusive: "retailer_exclusive",
+  ConventionExclusive: "convention_exclusive",
+  IncentiveVariant: "incentive_variant",
+  RatioVariant: "ratio_variant",
+  FoilVariant: "foil_variant",
+  SketchVariant: "sketch_variant",
+  VirginVariant: "virgin_variant",
+  BlankVariant: "blank_variant",
+  ArtistVariant: "artist_variant",
+  HologramVariant: "hologram_variant",
+  GlowInDarkVariant: "glow_in_dark_variant",
+  Facsimile: "facsimile",
+  Reprint: "reprint",
+  Other: "other",
+} as const;
+export type AddIssueToCollectionVariantType = ClosedEnum<
+  typeof AddIssueToCollectionVariantType
+>;
+
+/**
+ * Grading company (CGC, CBCS, PGX, other, self_graded).
+ */
+export const AddIssueToCollectionGradingCompany = {
+  Cgc: "CGC",
+  Cbcs: "CBCS",
+  Pgx: "PGX",
+  Other: "other",
+  SelfGraded: "self_graded",
+} as const;
+/**
+ * Grading company (CGC, CBCS, PGX, other, self_graded).
+ */
+export type AddIssueToCollectionGradingCompany = ClosedEnum<
+  typeof AddIssueToCollectionGradingCompany
+>;
+
+/**
+ * Slab label tier (e.g. universal, signature_series, restored, qualified).
+ */
+export const AddIssueToCollectionLabelType = {
+  Universal: "universal",
+  SignatureSeries: "signature_series",
+  Qualified: "qualified",
+  Restored: "restored",
+  Cgcxjsa: "cgcxjsa",
+  Standard: "standard",
+  VerifiedSignature: "verified_signature",
+  Signed: "signed",
+  Conserved: "conserved",
+} as const;
+/**
+ * Slab label tier (e.g. universal, signature_series, restored, qualified).
+ */
+export type AddIssueToCollectionLabelType = ClosedEnum<
+  typeof AddIssueToCollectionLabelType
+>;
+
+/**
+ * Interior page color quality from the slab label.
+ */
+export const AddIssueToCollectionPageQuality = {
+  White: "white",
+  OffWhiteToWhite: "off_white_to_white",
+  OffWhite: "off_white",
+  CreamToOffWhite: "cream_to_off_white",
+  LightTan: "light_tan",
+  Tan: "tan",
+  Brittle: "brittle",
+} as const;
+/**
+ * Interior page color quality from the slab label.
+ */
+export type AddIssueToCollectionPageQuality = ClosedEnum<
+  typeof AddIssueToCollectionPageQuality
+>;
+
+export const AddIssueToCollectionPrintNumber = {
+  Onest: "1st",
+  Twond: "2nd",
+  Threerd: "3rd",
+  Fourth: "4th",
+  Fiveth: "5th",
+  Sixth: "6th",
+  Seventh: "7th",
+  Eightth: "8th",
+  Nineth: "9th",
+  Tenth: "10th",
+  Other: "other",
+} as const;
+export type AddIssueToCollectionPrintNumber = ClosedEnum<
+  typeof AddIssueToCollectionPrintNumber
+>;
+
+export const AddIssueToCollectionSignatureWitness = {
+  Cgc: "CGC",
+  Cbcs: "CBCS",
+  Jsa: "JSA",
+  PsaDna: "PSA/DNA",
+  WitnessedInPerson: "witnessed_in_person",
+  Unwitnessed: "unwitnessed",
+  Other: "other",
+} as const;
+export type AddIssueToCollectionSignatureWitness = ClosedEnum<
+  typeof AddIssueToCollectionSignatureWitness
+>;
+
+export type AddIssueToCollectionRequestBody = {
+  /**
+   * Specific variant ID (optional).
+   */
+  variantId?: number | null | undefined;
+  /**
+   * Condition grade (e.g., NM, VF, FN, VG, G, FR, PR).
+   */
+  condition?: string | null | undefined;
+  /**
+   * Personal notes (max 1000 chars).
+   */
+  notes?: string | null | undefined;
+  /**
+   * Price paid (max 999999.99).
+   */
+  pricePaid?: number | null | undefined;
+  /**
+   * Physical format of the copy.
+   */
+  format?: AddIssueToCollectionFormat | null | undefined;
+  /**
+   * Where the comic was purchased.
+   */
+  purchaseSource?: AddIssueToCollectionPurchaseSource | null | undefined;
+  /**
+   * ID of the specific comic shop the copy was purchased from. Self-reported; independent of purchase_source. The <code>id</code> of an existing record in the comic_shops table.
+   */
+  comicShopId?: number | null | undefined;
+  /**
+   * How the comic was acquired.
+   */
+  acquisitionMethod?: AddIssueToCollectionAcquisitionMethod | null | undefined;
+  /**
+   * Date of purchase (YYYY-MM-DD). Must be a valid date.
+   */
+  purchasedAt?: string | null | undefined;
+  /**
+   * Where the comic is stored. Must not be greater than 255 characters.
+   */
+  storageLocation?: string | null | undefined;
+  /**
+   * Whether the comic is signed.
+   */
+  isSigned?: boolean | undefined;
+  /**
+   * Name(s) of the creator(s) who signed the comic. Free-text — comma-separate multiple signers. Must not be greater than 255 characters.
+   */
+  signedBy?: string | null | undefined;
+  isVariant?: boolean | undefined;
+  /**
+   * Must not be greater than 500 characters.
+   */
+  variantDescription?: string | null | undefined;
+  variantType?: AddIssueToCollectionVariantType | null | undefined;
+  /**
+   * Whether the comic is professionally graded.
+   */
+  graded?: boolean | undefined;
+  /**
+   * Numeric grade score (e.g. 9.8). Must not be greater than 10 characters.
+   */
+  gradeScore?: string | null | undefined;
+  /**
+   * Grading company (CGC, CBCS, PGX, other, self_graded).
+   */
+  gradingCompany?: AddIssueToCollectionGradingCompany | null | undefined;
+  /**
+   * Grading certification number. Must not be greater than 50 characters.
+   */
+  gradingNumber?: string | null | undefined;
+  /**
+   * Slab label tier (e.g. universal, signature_series, restored, qualified).
+   */
+  labelType?: AddIssueToCollectionLabelType | null | undefined;
+  /**
+   * Interior page color quality from the slab label.
+   */
+  pageQuality?: AddIssueToCollectionPageQuality | null | undefined;
+  /**
+   * Free-text notes printed on the slab label. Must not be greater than 2000 characters.
+   */
+  graderNotes?: string | null | undefined;
+  printNumber?: AddIssueToCollectionPrintNumber | null | undefined;
+  signatureWitness?: AddIssueToCollectionSignatureWitness | null | undefined;
+  /**
+   * Current estimated value in dollars. Must be at least 0. Must not be greater than 999999.99.
+   */
+  estimatedValue?: number | null | undefined;
+  /**
+   * Whether the item is for sale.
+   */
+  forSale?: boolean | undefined;
+  /**
+   * Whether the item is available for trade.
+   */
+  forTrade?: boolean | undefined;
+  /**
+   * Whether this collection item is publicly visible. Defaults to true.
+   */
+  isPublic?: boolean | undefined;
+};
+
+export type AddIssueToCollectionRequest = {
+  /**
+   * The issue ID.
+   */
+  issueId: number;
+  body?: AddIssueToCollectionRequestBody | undefined;
+};
+
+export type AddIssueToCollectionIssue = {
+  id?: number | undefined;
+  number?: string | undefined;
+  title?: string | undefined;
+};
+
+export type AddIssueToCollectionSeries = {
+  id?: number | undefined;
+  name?: string | undefined;
+};
+
+export type AddIssueToCollectionData = {
+  id?: number | undefined;
+  issue?: AddIssueToCollectionIssue | undefined;
+  series?: AddIssueToCollectionSeries | undefined;
+  variantId?: string | null | undefined;
+  condition?: string | undefined;
+  pricePaid?: number | undefined;
+  notes?: string | undefined;
+};
+
+/**
+ * Added
+ */
+export type AddIssueToCollectionResponseBody = {
+  data?: AddIssueToCollectionData | undefined;
+};
+
+export type AddIssueToCollectionResponse = {
+  headers: { [k: string]: Array<string> };
+  result: AddIssueToCollectionResponseBody;
+};
+
+/** @internal */
+export const AddIssueToCollectionFormat$outboundSchema: z.ZodMiniEnum<
+  typeof AddIssueToCollectionFormat
+> = z.enum(AddIssueToCollectionFormat);
+
+/** @internal */
+export const AddIssueToCollectionPurchaseSource$outboundSchema: z.ZodMiniEnum<
+  typeof AddIssueToCollectionPurchaseSource
+> = z.enum(AddIssueToCollectionPurchaseSource);
+
+/** @internal */
+export const AddIssueToCollectionAcquisitionMethod$outboundSchema:
+  z.ZodMiniEnum<typeof AddIssueToCollectionAcquisitionMethod> = z.enum(
+    AddIssueToCollectionAcquisitionMethod,
+  );
+
+/** @internal */
+export const AddIssueToCollectionVariantType$outboundSchema: z.ZodMiniEnum<
+  typeof AddIssueToCollectionVariantType
+> = z.enum(AddIssueToCollectionVariantType);
+
+/** @internal */
+export const AddIssueToCollectionGradingCompany$outboundSchema: z.ZodMiniEnum<
+  typeof AddIssueToCollectionGradingCompany
+> = z.enum(AddIssueToCollectionGradingCompany);
+
+/** @internal */
+export const AddIssueToCollectionLabelType$outboundSchema: z.ZodMiniEnum<
+  typeof AddIssueToCollectionLabelType
+> = z.enum(AddIssueToCollectionLabelType);
+
+/** @internal */
+export const AddIssueToCollectionPageQuality$outboundSchema: z.ZodMiniEnum<
+  typeof AddIssueToCollectionPageQuality
+> = z.enum(AddIssueToCollectionPageQuality);
+
+/** @internal */
+export const AddIssueToCollectionPrintNumber$outboundSchema: z.ZodMiniEnum<
+  typeof AddIssueToCollectionPrintNumber
+> = z.enum(AddIssueToCollectionPrintNumber);
+
+/** @internal */
+export const AddIssueToCollectionSignatureWitness$outboundSchema: z.ZodMiniEnum<
+  typeof AddIssueToCollectionSignatureWitness
+> = z.enum(AddIssueToCollectionSignatureWitness);
+
+/** @internal */
+export type AddIssueToCollectionRequestBody$Outbound = {
+  variant_id?: number | null | undefined;
+  condition?: string | null | undefined;
+  notes?: string | null | undefined;
+  price_paid?: number | null | undefined;
+  format?: string | null | undefined;
+  purchase_source?: string | null | undefined;
+  comic_shop_id?: number | null | undefined;
+  acquisition_method?: string | null | undefined;
+  purchased_at?: string | null | undefined;
+  storage_location?: string | null | undefined;
+  is_signed?: boolean | undefined;
+  signed_by?: string | null | undefined;
+  is_variant?: boolean | undefined;
+  variant_description?: string | null | undefined;
+  variant_type?: string | null | undefined;
+  graded?: boolean | undefined;
+  grade_score?: string | null | undefined;
+  grading_company?: string | null | undefined;
+  grading_number?: string | null | undefined;
+  label_type?: string | null | undefined;
+  page_quality?: string | null | undefined;
+  grader_notes?: string | null | undefined;
+  print_number?: string | null | undefined;
+  signature_witness?: string | null | undefined;
+  estimated_value?: number | null | undefined;
+  for_sale?: boolean | undefined;
+  for_trade?: boolean | undefined;
+  is_public?: boolean | undefined;
+};
+
+/** @internal */
+export const AddIssueToCollectionRequestBody$outboundSchema: z.ZodMiniType<
+  AddIssueToCollectionRequestBody$Outbound,
+  AddIssueToCollectionRequestBody
+> = z.pipe(
+  z.object({
+    variantId: z.optional(z.nullable(z.int())),
+    condition: z.optional(z.nullable(z.string())),
+    notes: z.optional(z.nullable(z.string())),
+    pricePaid: z.optional(z.nullable(z.number())),
+    format: z.optional(z.nullable(AddIssueToCollectionFormat$outboundSchema)),
+    purchaseSource: z.optional(
+      z.nullable(AddIssueToCollectionPurchaseSource$outboundSchema),
+    ),
+    comicShopId: z.optional(z.nullable(z.int())),
+    acquisitionMethod: z.optional(
+      z.nullable(AddIssueToCollectionAcquisitionMethod$outboundSchema),
+    ),
+    purchasedAt: z.optional(z.nullable(z.string())),
+    storageLocation: z.optional(z.nullable(z.string())),
+    isSigned: z.optional(z.boolean()),
+    signedBy: z.optional(z.nullable(z.string())),
+    isVariant: z.optional(z.boolean()),
+    variantDescription: z.optional(z.nullable(z.string())),
+    variantType: z.optional(
+      z.nullable(AddIssueToCollectionVariantType$outboundSchema),
+    ),
+    graded: z.optional(z.boolean()),
+    gradeScore: z.optional(z.nullable(z.string())),
+    gradingCompany: z.optional(
+      z.nullable(AddIssueToCollectionGradingCompany$outboundSchema),
+    ),
+    gradingNumber: z.optional(z.nullable(z.string())),
+    labelType: z.optional(
+      z.nullable(AddIssueToCollectionLabelType$outboundSchema),
+    ),
+    pageQuality: z.optional(
+      z.nullable(AddIssueToCollectionPageQuality$outboundSchema),
+    ),
+    graderNotes: z.optional(z.nullable(z.string())),
+    printNumber: z.optional(
+      z.nullable(AddIssueToCollectionPrintNumber$outboundSchema),
+    ),
+    signatureWitness: z.optional(
+      z.nullable(AddIssueToCollectionSignatureWitness$outboundSchema),
+    ),
+    estimatedValue: z.optional(z.nullable(z.number())),
+    forSale: z.optional(z.boolean()),
+    forTrade: z.optional(z.boolean()),
+    isPublic: z.optional(z.boolean()),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      variantId: "variant_id",
+      pricePaid: "price_paid",
+      purchaseSource: "purchase_source",
+      comicShopId: "comic_shop_id",
+      acquisitionMethod: "acquisition_method",
+      purchasedAt: "purchased_at",
+      storageLocation: "storage_location",
+      isSigned: "is_signed",
+      signedBy: "signed_by",
+      isVariant: "is_variant",
+      variantDescription: "variant_description",
+      variantType: "variant_type",
+      gradeScore: "grade_score",
+      gradingCompany: "grading_company",
+      gradingNumber: "grading_number",
+      labelType: "label_type",
+      pageQuality: "page_quality",
+      graderNotes: "grader_notes",
+      printNumber: "print_number",
+      signatureWitness: "signature_witness",
+      estimatedValue: "estimated_value",
+      forSale: "for_sale",
+      forTrade: "for_trade",
+      isPublic: "is_public",
+    });
+  }),
+);
+
+export function addIssueToCollectionRequestBodyToJSON(
+  addIssueToCollectionRequestBody: AddIssueToCollectionRequestBody,
+): string {
+  return JSON.stringify(
+    AddIssueToCollectionRequestBody$outboundSchema.parse(
+      addIssueToCollectionRequestBody,
+    ),
+  );
+}
+
+/** @internal */
+export type AddIssueToCollectionRequest$Outbound = {
+  issue_id: number;
+  body?: AddIssueToCollectionRequestBody$Outbound | undefined;
+};
+
+/** @internal */
+export const AddIssueToCollectionRequest$outboundSchema: z.ZodMiniType<
+  AddIssueToCollectionRequest$Outbound,
+  AddIssueToCollectionRequest
+> = z.pipe(
+  z.object({
+    issueId: z.int(),
+    body: z.optional(
+      z.lazy(() => AddIssueToCollectionRequestBody$outboundSchema),
+    ),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      issueId: "issue_id",
+    });
+  }),
+);
+
+export function addIssueToCollectionRequestToJSON(
+  addIssueToCollectionRequest: AddIssueToCollectionRequest,
+): string {
+  return JSON.stringify(
+    AddIssueToCollectionRequest$outboundSchema.parse(
+      addIssueToCollectionRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const AddIssueToCollectionIssue$inboundSchema: z.ZodMiniType<
+  AddIssueToCollectionIssue,
+  unknown
+> = z.object({
+  id: types.optional(types.number()),
+  number: types.optional(types.string()),
+  title: types.optional(types.string()),
+});
+
+export function addIssueToCollectionIssueFromJSON(
+  jsonString: string,
+): SafeParseResult<AddIssueToCollectionIssue, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AddIssueToCollectionIssue$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AddIssueToCollectionIssue' from JSON`,
+  );
+}
+
+/** @internal */
+export const AddIssueToCollectionSeries$inboundSchema: z.ZodMiniType<
+  AddIssueToCollectionSeries,
+  unknown
+> = z.object({
+  id: types.optional(types.number()),
+  name: types.optional(types.string()),
+});
+
+export function addIssueToCollectionSeriesFromJSON(
+  jsonString: string,
+): SafeParseResult<AddIssueToCollectionSeries, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AddIssueToCollectionSeries$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AddIssueToCollectionSeries' from JSON`,
+  );
+}
+
+/** @internal */
+export const AddIssueToCollectionData$inboundSchema: z.ZodMiniType<
+  AddIssueToCollectionData,
+  unknown
+> = z.pipe(
+  z.object({
+    id: types.optional(types.number()),
+    issue: types.optional(
+      z.lazy(() => AddIssueToCollectionIssue$inboundSchema),
+    ),
+    series: types.optional(
+      z.lazy(() => AddIssueToCollectionSeries$inboundSchema),
+    ),
+    variant_id: z.optional(z.nullable(types.string())),
+    condition: types.optional(types.string()),
+    price_paid: types.optional(types.number()),
+    notes: types.optional(types.string()),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "variant_id": "variantId",
+      "price_paid": "pricePaid",
+    });
+  }),
+);
+
+export function addIssueToCollectionDataFromJSON(
+  jsonString: string,
+): SafeParseResult<AddIssueToCollectionData, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AddIssueToCollectionData$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AddIssueToCollectionData' from JSON`,
+  );
+}
+
+/** @internal */
+export const AddIssueToCollectionResponseBody$inboundSchema: z.ZodMiniType<
+  AddIssueToCollectionResponseBody,
+  unknown
+> = z.object({
+  data: types.optional(z.lazy(() => AddIssueToCollectionData$inboundSchema)),
+});
+
+export function addIssueToCollectionResponseBodyFromJSON(
+  jsonString: string,
+): SafeParseResult<AddIssueToCollectionResponseBody, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AddIssueToCollectionResponseBody$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AddIssueToCollectionResponseBody' from JSON`,
+  );
+}
+
+/** @internal */
+export const AddIssueToCollectionResponse$inboundSchema: z.ZodMiniType<
+  AddIssueToCollectionResponse,
+  unknown
+> = z.pipe(
+  z.object({
+    Headers: z._default(z.record(z.string(), z.array(z.string())), {}),
+    Result: z.lazy(() => AddIssueToCollectionResponseBody$inboundSchema),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "Headers": "headers",
+      "Result": "result",
+    });
+  }),
+);
+
+export function addIssueToCollectionResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<AddIssueToCollectionResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AddIssueToCollectionResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AddIssueToCollectionResponse' from JSON`,
+  );
+}