# fm.freemix.group.samples

> Published by [lex-publisher.freemix.fm](https://lexicon.garden/identity/did:plc:bt7c6cqevgefnvej5cmgke4g)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:bt7c6cqevgefnvej5cmgke4g/fm.freemix.group.samples)
- [Documentation](https://lexicon.garden/lexicon/did:plc:bt7c6cqevgefnvej5cmgke4g/fm.freemix.group.samples/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:bt7c6cqevgefnvej5cmgke4g/fm.freemix.group.samples/examples)

## Definitions

### `fm.freemix.group.samples`

**Type**: `record`

A samples group: a structural grouping of samples uploaded and presented as a unit, independent of any release (FM-824; mirrors fm.freemix.group.stems, FM-549 s38). A sample PACK is this same record with a price — one record type, pricing optional. Points DOWN at its member samples, which carry an optional parentGroup back-ref (the only upward ref); members[] is authoritative for membership and order. RELATIONSHIP TO fm.freemix.release: a release is a separate 'put-out work' wrapper that MAY include this record as one of its members; this record is the structural group itself, not the release. Selling sample packs is NOT implemented — priceCents/currency reserve the shape only.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `coverArtUrl` | `string` (uri) | No | URL to cover art image. |
| `createdAt` | `string` (datetime) | Yes | Record creation timestamp. |
| `currency` | `string` | No | ISO-4217 currency code. Phase 1 = USD only. INLINE sellability shape — keep in sync across sellable types. |
| `description` | `string` | No | Samples-group description. |
| `members` | `array` | No | Ordered member samples (container points DOWN at members). AT-URI refs to fm.freemix.sample records. Samples also carry an optional parentGroup back-ref (the only upward ref). |
| `priceCents` | `integer` | No | On-network price in integer cents (FM-549: price on-network; offer public, sale private). 0 or absent = free; a priced group is a sample pack. The bundle price: one price covers the whole samples group (no per-sample pricing). Hard price floor enforced in app. INLINE sellability shape — authored identically in fm.freemix.release and fm.freemix.group.stems; keep in sync (s41). RESERVED: selling sample packs is not implemented. |
| `seller` | `string` (did) | Yes | parties.seller (s39): the single account DID that owns and sells this samples group. Charge/entitlement read THIS field. INLINE — keep in sync. |
| `title` | `string` | Yes | The samples-group name, and the sold-product name buyers see when it is priced (e.g. 'Midnight Drive — Drum Hits'). |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A samples group: a structural grouping of samples uploaded and presented as a unit, independent of any release (FM-824; mirrors fm.freemix.group.stems, FM-549 s38). A sample PACK is this same record with a price — one record type, pricing optional. Points DOWN at its member samples, which carry an optional parentGroup back-ref (the only upward ref); members[] is authoritative for membership and order. RELATIONSHIP TO fm.freemix.release: a release is a separate 'put-out work' wrapper that MAY include this record as one of its members; this record is the structural group itself, not the release. Selling sample packs is NOT implemented — priceCents/currency reserve the shape only.",
      "key": "tid",
      "record": {
        "properties": {
          "coverArtUrl": {
            "description": "URL to cover art image.",
            "format": "uri",
            "maxLength": 3000,
            "type": "string"
          },
          "createdAt": {
            "description": "Record creation timestamp.",
            "format": "datetime",
            "maxLength": 100,
            "type": "string"
          },
          "currency": {
            "description": "ISO-4217 currency code. Phase 1 = USD only. INLINE sellability shape — keep in sync across sellable types.",
            "knownValues": [
              "USD"
            ],
            "maxLength": 3,
            "type": "string"
          },
          "description": {
            "description": "Samples-group description.",
            "maxLength": 5000,
            "type": "string"
          },
          "members": {
            "description": "Ordered member samples (container points DOWN at members). AT-URI refs to fm.freemix.sample records. Samples also carry an optional parentGroup back-ref (the only upward ref).",
            "items": {
              "properties": {
                "cid": {
                  "description": "CID of the member sample (pins to exact version). Optional.",
                  "format": "cid",
                  "maxLength": 200,
                  "type": "string"
                },
                "position": {
                  "description": "Display order within the group (0-indexed).",
                  "minimum": 0,
                  "type": "integer"
                },
                "uri": {
                  "description": "AT URI of the member sample record.",
                  "format": "at-uri",
                  "maxLength": 3000,
                  "type": "string"
                }
              },
              "required": [
                "uri"
              ],
              "type": "object"
            },
            "maxLength": 200,
            "type": "array"
          },
          "priceCents": {
            "description": "On-network price in integer cents (FM-549: price on-network; offer public, sale private). 0 or absent = free; a priced group is a sample pack. The bundle price: one price covers the whole samples group (no per-sample pricing). Hard price floor enforced in app. INLINE sellability shape — authored identically in fm.freemix.release and fm.freemix.group.stems; keep in sync (s41). RESERVED: selling sample packs is not implemented.",
            "minimum": 0,
            "type": "integer"
          },
          "seller": {
            "description": "parties.seller (s39): the single account DID that owns and sells this samples group. Charge/entitlement read THIS field. INLINE — keep in sync.",
            "format": "did",
            "type": "string"
          },
          "title": {
            "description": "The samples-group name, and the sold-product name buyers see when it is priced (e.g. 'Midnight Drive — Drum Hits').",
            "maxLength": 300,
            "type": "string"
          }
        },
        "required": [
          "title",
          "seller",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "fm.freemix.group.samples",
  "lexicon": 1
}
```