# app.atomes.copy

> A physical book the reader owns: one Copy of an Edition. A reader can own several Copies of the same Edition. Never Shared.

- Kind: record
- Record key: tid
- Authority: atomes.app
- Lexicon: 1
- Published by [neilujd.bsky.social](https://lexicon.garden/identity/did:plc:zqiqz76wf24fttlb2r73evli), the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:zqiqz76wf24fttlb2r73evli/app.atomes.copy)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:zqiqz76wf24fttlb2r73evli/app.atomes.copy/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:zqiqz76wf24fttlb2r73evli/app.atomes.copy/analytics)

## Record (`app.atomes.copy`)

Type: record · key tid

### Properties

- `acquiredAt` (string · datetime): When the reader got this Copy, if they said.
- `createdAt` (string · datetime, required)
- `details` (ref): Typed by the reader when the Catalog does not know this ISBN.
  - Reference: `#bookDetails`
- `isbn` (string, required): The Edition: ISBN-13, 13 digits, no hyphens.
  - Constraints: minLength: 13, maxLength: 13
- `lentTo` (string): Who has this Copy now. Absent when the reader has it.
  - Constraints: maxLength: 640, maxGraphemes: 64
- `works` (array, required): Catalog identifiers of the Works this Copy contains; several for an omnibus. 'isbn:<isbn13>' when the Catalog does not know the Work.
  - Constraints: minLength: 1, maxLength: 50
  - `items` (string)
    - Constraints: maxLength: 128

## #bookDetails (`app.atomes.copy#bookDetails`)

Type: object

### Properties

- `authors` (array)
  - Constraints: maxLength: 20
  - `items` (string)
    - Constraints: maxLength: 640, maxGraphemes: 64
- `series` (string): Series title, as typed. Not a Catalog identifier.
  - Constraints: maxLength: 3000, maxGraphemes: 300
- `title` (string, required)
  - Constraints: maxLength: 3000, maxGraphemes: 300
- `volume` (string): Volume in the Series, as printed (e.g. '12', '12.5').
  - Constraints: maxLength: 64, maxGraphemes: 16

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "bookDetails": {
      "properties": {
        "authors": {
          "items": {
            "maxGraphemes": 64,
            "maxLength": 640,
            "type": "string"
          },
          "maxLength": 20,
          "type": "array"
        },
        "series": {
          "description": "Series title, as typed. Not a Catalog identifier.",
          "maxGraphemes": 300,
          "maxLength": 3000,
          "type": "string"
        },
        "title": {
          "maxGraphemes": 300,
          "maxLength": 3000,
          "type": "string"
        },
        "volume": {
          "description": "Volume in the Series, as printed (e.g. '12', '12.5').",
          "maxGraphemes": 16,
          "maxLength": 64,
          "type": "string"
        }
      },
      "required": [
        "title"
      ],
      "type": "object"
    },
    "main": {
      "description": "A physical book the reader owns: one Copy of an Edition. A reader can own several Copies of the same Edition. Never Shared.",
      "key": "tid",
      "record": {
        "properties": {
          "acquiredAt": {
            "description": "When the reader got this Copy, if they said.",
            "format": "datetime",
            "type": "string"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "details": {
            "description": "Typed by the reader when the Catalog does not know this ISBN.",
            "ref": "#bookDetails",
            "type": "ref"
          },
          "isbn": {
            "description": "The Edition: ISBN-13, 13 digits, no hyphens.",
            "maxLength": 13,
            "minLength": 13,
            "type": "string"
          },
          "lentTo": {
            "description": "Who has this Copy now. Absent when the reader has it.",
            "maxGraphemes": 64,
            "maxLength": 640,
            "type": "string"
          },
          "works": {
            "description": "Catalog identifiers of the Works this Copy contains; several for an omnibus. 'isbn:<isbn13>' when the Catalog does not know the Work.",
            "items": {
              "maxLength": 128,
              "type": "string"
            },
            "maxLength": 50,
            "minLength": 1,
            "type": "array"
          }
        },
        "required": [
          "isbn",
          "works",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "app.atomes.copy",
  "lexicon": 1
}
```