cocina-models 0.58.2 → 0.59.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 373c87def65c96c5e54fca772ded4c486a26ed1ed2ec5679e4d1f4483241d950
-  data.tar.gz: 58fd159bc6341d831d42ffd59cb7c42ff8fb0643c87c724753e69c100ec271f4
+  metadata.gz: d472f28820d79530461986e33333e5992ccb186f49b87a8a1cb72c3ffb86aa3b
+  data.tar.gz: 19bb67df011f97b52ec3bdbbe847a2fdebabbacc1dd3a322279eedb1c73aec50
 SHA512:
-  metadata.gz: 1ef5aec119f9230e8a274d2c97130c1c1fa421acf227f856613e7c2fb93542ef6f2af64b22e87b44448b6f428b37ba9e091bc1ed01acd16058f30329156e0d31
-  data.tar.gz: 759e9eee67dc7fc016727e0a4954c07c9d5d1a7a36b5f0eda210b26a12550112210bd7b0b8e59f0ab45e5a57b8e685fb377abb8a78ff74777ebbdc64c474c38a
+  metadata.gz: ac7b48e7ea013bd36fe1dc15f1c1a6826bade90358b7c2c43697af4945d1b5e9fac44acaa08f87233609fcb5e8c53598a85b656157ad33aa96ff8baea20400fe
+  data.tar.gz: b260daadd1e73062df358ef214a6d0417d3b0d5f0c493ad22fe0025019822c4386f5e23bedaec6517d4678c3b766050816def14f329ca3b78f6dbca597ac3cbc

data/.rubocop.yml

@@ -79,6 +79,8 @@ Metrics/BlockLength:
 
 Metrics/MethodLength:
   Max: 14
+  Exclude:
+    - 'spec/cocina/models/file_access_spec.rb'
 
 # ----- RSpec ------
 

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2020-09-08 19:05:09 UTC using RuboCop version 0.89.1.
+# on 2021-04-16 17:25:55 UTC using RuboCop version 0.93.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -8,15 +8,15 @@
 
 # Offense count: 1
 # Configuration parameters: AllowedMethods.
-# AllowedMethods: present?, blank?, presence, try, try!
+# AllowedMethods: present?, blank?, presence, try, try!, in?
 Lint/SafeNavigationChain:
   Exclude:
     - 'lib/cocina/generator/schema_base.rb'
 
 # Offense count: 1
-# Configuration parameters: IgnoredMethods.
-Metrics/CyclomaticComplexity:
-  Max: 8
+# Configuration parameters: CountKeywordArgs.
+Metrics/ParameterLists:
+  Max: 6
 
 # Offense count: 1
 # Configuration parameters: MinBodyLength.

data/README.md

@@ -8,7 +8,7 @@
 
 This is a Ruby implementation of the SDR data model (named "COCINA"). The data being modeled includes digital repository objects.
 
-Validation is performed by openapi (using OpenAPIParser). Modeling is provided by dry-struct and dry-types. Together, these provide a way for consumers to validate objects against models and to manipulate thos objects.
+Validation is performed by openapi (using OpenAPIParser). Modeling is provided by dry-struct and dry-types. Together, these provide a way for consumers to validate objects against models and to manipulate those objects.
 
 This is a work in progress that will ultimately implement the full [COCINA data model](http://sul-dlss.github.io/cocina-models/). See also [architecture documentation](https://sul-dlss.github.io/taco-truck/COCINA.html#cocina-data-models--shapes).
 
@@ -34,44 +34,53 @@ Beyond what is necessary to test the generator, the Cocina model classes are not
 
 ## Releasing
 
+### Step 0: Share intent to change the models
+
+Send a note to `#dlss-infra-chg-mgmt` on Slack to let people know what is changing and when.
+
+### Step 1: Cut the release
+
 The release process is much like any other gem. First bump the version in `lib/cocina/models/version.rb`, and commit the result. Then run:
 ```
 bundle exec rake release
 ```
 which pushes the gem to rubygems.org.  Next write up the release notes: https://github.com/sul-dlss/cocina-models/releases .
 
-Finally, you must release versions of [sdr-client](https://github.com/sul-dlss/sdr-client) and [dor-services-client](https://github.com/sul-dlss/dor-services-client/) pinned to this version because [Argo](https://github.com/sul-dlss/argo) depends on both of those. When [dor-services-app](https://github.com/sul-dlss/dor-services-app) is updated to use the new models (via the auto-update script), the clients must be updated at the same time or there is risk of models produced by dor-services-app not being acceptable to the clients.
+### Step 2: Update client gems coupled to the models
 
-### Communicate
+Next, you should release versions of [sdr-client](https://github.com/sul-dlss/sdr-client) and [dor-services-client](https://github.com/sul-dlss/dor-services-client/) pinned to this version because applications such as [Argo](https://github.com/sul-dlss/argo) depend on both of these gems using the same models.
 
-Send a note to `#dlss-infra-chg-mgmt` on Slack to let people know what is changing and when.
+### Step 3: Update service API specifications and gems
+
+The cocina-models gem is used in applications that have an API specification that accepts Cocina models. Next, make sure that the `openapi.yml` for these applications include the `openapi.yml` schema changes made in cocina-models. This list of services is known to include:
+
+* [sul-dlss/sdr-api](https://github.com/sul-dlss/sdr-api)
+* [sul-dlss/dor-services-app](https://github.com/sul-dlss/dor-services-app/)
 
-### Dependent Services
+This can be accomplished by copying and pasting these schemas. By convention, these schemas are listed first in the `openapi.yml` of the associated projects, followed by the application-specific schemas.
 
-Once the above listed gems are updated all the following services that use cocina-models should be updated and released at the same time:
+#### Step 3b: Bump gems
 
-* sul-dlss/sdr-api
-* sul-dlss/dor-services-app
-* sul-dlss/google-books
-* sul-dlss/common-accessioning
-* sul-dlss/argo
-* sul-dlss/pre-assembly
-* sul-dlss/hydrus
-* sul-dlss/happy-heron
-* sul-dlss/infrastructure-integration-test
-* sul-dlss/dor_indexing_app
+At the same, we have found it convenient to use these PRs to also bump the versions of cocina-models, sdr-client, and dor-services-client in these applications/services. Why? When [dor-services-app](https://github.com/sul-dlss/dor-services-app), for example, is updated to use the new models (via the auto-update script), these clients should be updated at the same time or there is risk of models produced by dor-services-app not being acceptable to the clients.
 
-## Using this gem
+### Step 4: Update other dependent applications
 
-If you are using this gem in an application that has an API that accepts Cocina models (e.g., SDR API, Dor-Services-App), make sure that the `openapi.yml` for the application includes the schemas that match the schemas in this `openapi.yml`.
+Once the above listed steps have been completed, all the following applications that use cocina-models should be updated and released at the same time:
 
-This can be accomplished by cutting and pasting these schemas. By convention, these schemas are listed first in the `openapi.yml` of the associated projects, followed by the application-specific schemas.
+* [sul-dlss/dor_indexing_app](https://github.com/sul-dlss/dor_indexing_app/)
+* [sul-dlss/common-accessioning](https://github.com/sul-dlss/common-accessioning/)
+* [sul-dlss/google-books](https://github.com/sul-dlss/google-books/)
+* [sul-dlss/argo](https://github.com/sul-dlss/argo/)
+* [sul-dlss/pre-assembly](https://github.com/sul-dlss/pre-assembly/)
+* [sul-dlss/hydrus](https://github.com/sul-dlss/hydrus/)
+* [sul-dlss/happy-heron](https://github.com/sul-dlss/happy-heron/)
+* [sul-dlss/infrastructure-integration-test](https://github.com/sul-dlss/infrastructure-integration-test/)
 
-### Usage conventions
+## Usage conventions
 
 The following are the recommended naming conventions for code using Cocina models:
 
-* cocina_item: Cocina::Models::DRO instance
-* cocina_admin_policy: Cocina::Models::AdminPolicy instance
-* cocina_collection: Cocina::Models::Collection instance
-* cocina_object: Cocina::Models::DRO or Cocina::Models::AdminPolicy or Cocina::Models::Collection instance
+* `cocina_item`: `Cocina::Models::DRO` instance
+* `cocina_admin_policy`: `Cocina::Models::AdminPolicy` instance
+* `cocina_collection`: `Cocina::Models::Collection` instance
+* `cocina_object`: `Cocina::Models::DRO` or `Cocina::Models::AdminPolicy` or `Cocina::Models::Collection` instance

data/lib/cocina/generator/schema.rb

@@ -5,7 +5,7 @@ module Cocina
     # Class for generating from an openapi schema
     class Schema < SchemaBase
       def schema_properties
-        @schema_properties ||= (properties + all_of_properties).uniq(&:key)
+        @schema_properties ||= (properties + all_of_properties + one_of_properties).uniq(&:key)
       end
 
       def generate
@@ -83,15 +83,42 @@ module Cocina
         all_of_properties_for(schema_doc)
       end
 
+      def one_of_properties
+        one_of_properties_for(schema_doc)
+      end
+
       def all_of_properties_for(doc)
         return [] if doc.all_of.nil?
 
         doc.all_of.map do |all_of_schema|
           # All of for this + recurse
-          schema_properties_for(all_of_schema) + all_of_properties_for(all_of_schema)
+          schema_properties_for(all_of_schema) +
+            all_of_properties_for(all_of_schema) +
+            one_of_properties_for(all_of_schema)
         end.flatten
       end
 
+      def one_of_properties_for(doc)
+        return [] if doc.one_of.nil?
+
+        # All properties must be objects.
+        unless doc.one_of.all? { |schema| schema.type == 'object' }
+          raise 'All properties for oneOf must be objects'
+        end
+
+        doc.one_of.flat_map do |one_of_doc|
+          one_of_doc.properties.map do |key, properties_doc|
+            property_class_for(properties_doc).new(properties_doc,
+                                                   key: key,
+                                                   # The property does less validation because may vary between
+                                                   # different oneOf schemas. Validation is still performed
+                                                   # by openAPI.
+                                                   relaxed: true,
+                                                   parent: self)
+          end
+        end
+      end
+
       def schema_properties_for(doc)
         doc.properties.map do |key, properties_doc|
           property_class_for(properties_doc).new(properties_doc,

data/lib/cocina/generator/schema_array.rb

@@ -9,7 +9,7 @@ module Cocina
       end
 
       def omittable
-        if required
+        if required && !relaxed
           '.default([].freeze)'
         else
           '.meta(omittable: true)'

data/lib/cocina/generator/schema_base.rb

@@ -4,14 +4,15 @@ module Cocina
   module Generator
     # Base class for generating from openapi
     class SchemaBase
-      attr_reader :schema_doc, :key, :required, :nullable, :parent
+      attr_reader :schema_doc, :key, :required, :nullable, :parent, :relaxed
 
-      def initialize(schema_doc, key: nil, required: false, nullable: false, parent: nil)
+      def initialize(schema_doc, key: nil, required: false, nullable: false, parent: nil, relaxed: false)
         @schema_doc = schema_doc
         @key = key
         @required = required
         @nullable = nullable
         @parent = parent
+        @relaxed = relaxed
       end
 
       def filename
@@ -25,7 +26,7 @@ module Cocina
       # Allows non-required values to not be provided. This allows smaller
       # requests as not every field needs to be present.
       def omittable
-        return '' if required
+        return '' if required && !relaxed
 
         '.meta(omittable: true)'
       end
@@ -33,7 +34,7 @@ module Cocina
       # Allows nillable values to be set to nil. This is useful when doing
       # an update and you want to clear out a value.
       def optional
-        nullable ? '.optional' : ''
+        nullable || relaxed ? '.optional' : ''
       end
 
       def quote(item)
@@ -54,6 +55,12 @@ module Cocina
         "# example: #{schema_doc.example}\n"
       end
 
+      def relaxed_comment
+        return '' unless relaxed
+
+        "# Validation of this property is relaxed. See the openapi for full validation.\n"
+      end
+
       def dry_datatype(doc)
         case doc.type
         when 'integer'
@@ -63,7 +70,7 @@ module Cocina
         when 'boolean'
           'Strict::Bool'
         else
-          if doc.one_of&.map(&:type).all? { |o| %w[integer string].include?(o) }
+          if any_datatype?(doc)
             'Nominal::Any'
           else
             raise "#{schema_doc.type} not supported"
@@ -71,6 +78,10 @@ module Cocina
         end
       end
 
+      def any_datatype?(doc)
+        relaxed || doc.one_of&.map(&:type).all? { |o| %w[integer string].include?(o) }
+      end
+
       def string_dry_datatype(doc)
         case doc.format
         when 'date-time'

data/lib/cocina/generator/schema_ref.rb

@@ -5,7 +5,7 @@ module Cocina
     # Class for generating from an openapi reference
     class SchemaRef < SchemaBase
       def generate
-        if required
+        if required && !relaxed
           "attribute(:#{name.camelize(:lower)}, #{schema_doc.name}.default { #{schema_doc.name}.new })"
         else
           "attribute :#{name.camelize(:lower)}, #{schema_doc.name}.optional.meta(omittable: true)"

data/lib/cocina/generator/schema_value.rb

@@ -7,14 +7,14 @@ module Cocina
       # rubocop:disable Layout/LineLength
       def generate
         # optional has to come before default or the default value that gets set will be nil.
-        "#{description}#{example}attribute :#{name.camelize(:lower)}, Types::#{dry_datatype(schema_doc)}#{optional}#{default}#{enum}#{omittable}"
+        "#{description}#{example}#{relaxed_comment}attribute :#{name.camelize(:lower)}, Types::#{dry_datatype(schema_doc)}#{optional}#{default}#{enum}#{omittable}"
       end
       # rubocop:enable Layout/LineLength
 
       private
 
       def enum
-        return '' unless schema_doc.enum
+        return '' if !schema_doc.enum || relaxed
 
         items = use_types? ? "*#{parent.name}::TYPES" : schema_doc.enum.map { |item| quote(item) }.join(', ')
 

data/lib/cocina/models/access.rb

@@ -3,18 +3,17 @@
 module Cocina
   module Models
     class Access < Struct
-      # Access level
-      attribute :access, Types::Strict::String.default('dark').enum('world', 'stanford', 'location-based', 'citation-only', 'dark').meta(omittable: true)
-      # The human readable copyright statement that applies
-      # example: Copyright World Trade Organization
-      attribute :copyright, Types::Strict::String.meta(omittable: true)
+      # Access level.
+      # Validation of this property is relaxed. See the openapi for full validation.
+      attribute :access, Types::Strict::String.optional.default('dark').meta(omittable: true)
+      # Download access level.
+      # Validation of this property is relaxed. See the openapi for full validation.
+      attribute :download, Types::Strict::String.optional.default('none').meta(omittable: true)
       # If access is "location-based", which location should have access.
-      attribute :readLocation, Types::Strict::String.enum('spec', 'music', 'ars', 'art', 'hoover', 'm&m').meta(omittable: true)
-      # The human readable use and reproduction statement that applies
-      # example: Property rights reside with the repository. Literary rights reside with the creators of the documents or their heirs. To obtain permission to publish or reproduce, please contact the Public Services Librarian of the Dept. of Special Collections (http://library.stanford.edu/spc).
-      attribute :useAndReproductionStatement, Types::Strict::String.meta(omittable: true)
-      # The license governing reuse of the Collection. Should be an IRI for known licenses (i.e. CC, RightsStatement.org URI, etc.).
-      attribute :license, Types::Strict::String.meta(omittable: true)
+      # Validation of this property is relaxed. See the openapi for full validation.
+      attribute :readLocation, Types::Strict::String.optional.meta(omittable: true)
+      # Validation of this property is relaxed. See the openapi for full validation.
+      attribute :controlledDigitalLending, Types::Strict::Bool.optional.meta(omittable: true)
     end
   end
 end

data/lib/cocina/models/citation_only_access.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    class CitationOnlyAccess < Struct
+      # Access level.
+      attribute :access, Types::Strict::String.enum('citation-only')
+      # Download access level.
+      attribute :download, Types::Strict::String.enum('none')
+      # If access is "location-based", which location should have access.
+      attribute :readLocation, Types::Strict::String.optional.enum('').meta(omittable: true)
+      attribute :controlledDigitalLending, Types::Strict::Bool.enum(false).meta(omittable: true)
+    end
+  end
+end

data/lib/cocina/models/collection.rb

@@ -20,7 +20,7 @@ module Cocina
       attribute :label, Types::Strict::String
       # Version for the Collection within SDR.
       attribute :version, Types::Strict::Integer
-      attribute(:access, Access.default { Access.new })
+      attribute(:access, CollectionAccess.default { CollectionAccess.new })
       attribute :administrative, Administrative.optional.meta(omittable: true)
       attribute :description, Description.optional.meta(omittable: true)
       attribute :identification, CollectionIdentification.optional.meta(omittable: true)

data/lib/cocina/models/collection_access.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    class CollectionAccess < Struct
+      # Access level
+      attribute :access, Types::Strict::String.default('dark').enum('world', 'dark').meta(omittable: true)
+      # The human readable copyright statement that applies
+      # example: Copyright World Trade Organization
+      attribute :copyright, Types::Strict::String.meta(omittable: true)
+      # The human readable use and reproduction statement that applies
+      # example: Property rights reside with the repository. Literary rights reside with the creators of the documents or their heirs. To obtain permission to publish or reproduce, please contact the Public Services Librarian of the Dept. of Special Collections (http://library.stanford.edu/spc).
+      attribute :useAndReproductionStatement, Types::Strict::String.meta(omittable: true)
+      # The license governing reuse of the Collection. Should be an IRI for known licenses (i.e. CC, RightsStatement.org URI, etc.).
+      attribute :license, Types::Strict::String.meta(omittable: true)
+    end
+  end
+end

data/lib/cocina/models/controlled_digital_lending_access.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    class ControlledDigitalLendingAccess < Struct
+      # Access level.
+      attribute :access, Types::Strict::String.enum('stanford')
+      # Download access level.
+      attribute :download, Types::Strict::String.enum('none')
+      # If access is "location-based", which location should have access.
+      attribute :readLocation, Types::Strict::String.optional.enum('').meta(omittable: true)
+      # Available for controlled digital lending.
+      attribute :controlledDigitalLending, Types::Strict::Bool.default(false)
+    end
+  end
+end

data/lib/cocina/models/dark_access.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    class DarkAccess < Struct
+      # Access level.
+      attribute :access, Types::Strict::String.default('dark').enum('dark').meta(omittable: true)
+      # Download access level.
+      attribute :download, Types::Strict::String.default('none').enum('none').meta(omittable: true)
+      # If access is "location-based", which location should have access.
+      attribute :readLocation, Types::Strict::String.optional.enum('').meta(omittable: true)
+      attribute :controlledDigitalLending, Types::Strict::Bool.enum(false).meta(omittable: true)
+    end
+  end
+end

data/lib/cocina/models/dro_access.rb

@@ -3,19 +3,21 @@
 module Cocina
   module Models
     class DROAccess < Struct
-      attribute :access, Types::Strict::String.default('dark').enum('world', 'stanford', 'location-based', 'citation-only', 'dark').meta(omittable: true)
-      # Available for controlled digital lending.
-      attribute :controlledDigitalLending, Types::Strict::Bool.meta(omittable: true)
+      # Access level.
+      # Validation of this property is relaxed. See the openapi for full validation.
+      attribute :access, Types::Strict::String.optional.default('dark').meta(omittable: true)
+      # Download access level.
+      # Validation of this property is relaxed. See the openapi for full validation.
+      attribute :download, Types::Strict::String.optional.default('none').meta(omittable: true)
+      # If access is "location-based", which location should have access.
+      # Validation of this property is relaxed. See the openapi for full validation.
+      attribute :readLocation, Types::Strict::String.optional.meta(omittable: true)
+      # Validation of this property is relaxed. See the openapi for full validation.
+      attribute :controlledDigitalLending, Types::Strict::Bool.optional.meta(omittable: true)
       # The human readable copyright statement that applies
       # example: Copyright World Trade Organization
       attribute :copyright, Types::Strict::String.meta(omittable: true)
       attribute :embargo, Embargo.optional.meta(omittable: true)
-      # Download access level. This is used in the transition from Fedora as a way to set a default download level at registration that is copied down to all the files.
-
-      attribute :download, Types::Strict::String.default('none').enum('world', 'stanford', 'location-based', 'none').meta(omittable: true)
-      # If access is "location-based", which location should have access. This is used in the transition from Fedora as a way to set a default readLocation at registration that is copied down to all the files.
-
-      attribute :readLocation, Types::Strict::String.enum('spec', 'music', 'ars', 'art', 'hoover', 'm&m').meta(omittable: true)
       # The human readable use and reproduction statement that applies
       # example: Property rights reside with the repository. Literary rights reside with the creators of the documents or their heirs. To obtain permission to publish or reproduce, please contact the Public Services Librarian of the Dept. of Special Collections (http://library.stanford.edu/spc).
       attribute :useAndReproductionStatement, Types::Strict::String.meta(omittable: true)

data/lib/cocina/models/embargo.rb

@@ -3,11 +3,20 @@
 module Cocina
   module Models
     class Embargo < Struct
+      # Access level.
+      # Validation of this property is relaxed. See the openapi for full validation.
+      attribute :access, Types::Strict::String.optional.default('dark').meta(omittable: true)
+      # Download access level.
+      # Validation of this property is relaxed. See the openapi for full validation.
+      attribute :download, Types::Strict::String.optional.default('none').meta(omittable: true)
+      # If access is "location-based", which location should have access.
+      # Validation of this property is relaxed. See the openapi for full validation.
+      attribute :readLocation, Types::Strict::String.optional.meta(omittable: true)
+      # Validation of this property is relaxed. See the openapi for full validation.
+      attribute :controlledDigitalLending, Types::Strict::Bool.optional.meta(omittable: true)
       # Date when the Collection is released from an embargo.
       # example: 2029-06-22T07:00:00.000+00:00
       attribute :releaseDate, Types::Params::DateTime
-      # Access level that applies when embargo expires.
-      attribute :access, Types::Strict::String.enum('world', 'stanford', 'location-based', 'citation-only', 'dark')
       # The human readable use and reproduction statement that applies when the embargo expires.
       # example: These materials are in the public domain.
       attribute :useAndReproductionStatement, Types::Strict::String.meta(omittable: true)

data/lib/cocina/models/file_access.rb

@@ -3,14 +3,17 @@
 module Cocina
   module Models
     class FileAccess < Struct
-      # Access level
-      attribute :access, Types::Strict::String.default('dark').enum('world', 'stanford', 'location-based', 'citation-only', 'dark').meta(omittable: true)
-      # Available for controlled digital lending.
-      attribute :controlledDigitalLending, Types::Strict::Bool.meta(omittable: true)
-      # Download access level for a file
-      attribute :download, Types::Strict::String.default('none').enum('world', 'stanford', 'location-based', 'none').meta(omittable: true)
+      # Access level.
+      # Validation of this property is relaxed. See the openapi for full validation.
+      attribute :access, Types::Strict::String.optional.default('dark').meta(omittable: true)
+      # Download access level.
+      # Validation of this property is relaxed. See the openapi for full validation.
+      attribute :download, Types::Strict::String.optional.default('none').meta(omittable: true)
       # If access is "location-based", which location should have access.
-      attribute :readLocation, Types::Strict::String.enum('spec', 'music', 'ars', 'art', 'hoover', 'm&m').meta(omittable: true)
+      # Validation of this property is relaxed. See the openapi for full validation.
+      attribute :readLocation, Types::Strict::String.optional.meta(omittable: true)
+      # Validation of this property is relaxed. See the openapi for full validation.
+      attribute :controlledDigitalLending, Types::Strict::Bool.optional.meta(omittable: true)
     end
   end
 end

data/lib/cocina/models/location_based_access.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    class LocationBasedAccess < Struct
+      # Access level.
+      attribute :access, Types::Strict::String.enum('location-based')
+      # Download access level.
+      attribute :download, Types::Strict::String.enum('location-based', 'none')
+      # If access is "location-based", which location should have access.
+      attribute :readLocation, Types::Strict::String.enum('spec', 'music', 'ars', 'art', 'hoover', 'm&m')
+      attribute :controlledDigitalLending, Types::Strict::Bool.enum(false).meta(omittable: true)
+    end
+  end
+end

data/lib/cocina/models/location_based_download_access.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    class LocationBasedDownloadAccess < Struct
+      # Access level.
+      attribute :access, Types::Strict::String.enum('stanford', 'world')
+      # Download access level.
+      attribute :download, Types::Strict::String.enum('location-based')
+      # If access is "location-based", which location should have access.
+      attribute :readLocation, Types::Strict::String.enum('spec', 'music', 'ars', 'art', 'hoover', 'm&m')
+      attribute :controlledDigitalLending, Types::Strict::Bool.enum(false).meta(omittable: true)
+    end
+  end
+end

data/lib/cocina/models/request_collection.rb

@@ -15,7 +15,7 @@ module Cocina
       attribute :type, Types::Strict::String.enum(*RequestCollection::TYPES)
       attribute :label, Types::Strict::String
       attribute :version, Types::Strict::Integer
-      attribute(:access, Access.default { Access.new })
+      attribute(:access, CollectionAccess.default { CollectionAccess.new })
       attribute(:administrative, Administrative.default { Administrative.new })
       attribute :description, Description.optional.meta(omittable: true)
       attribute :identification, CollectionIdentification.optional.meta(omittable: true)

data/lib/cocina/models/stanford_access.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    class StanfordAccess < Struct
+      # Access level.
+      attribute :access, Types::Strict::String.enum('stanford')
+      # Download access level.
+      attribute :download, Types::Strict::String.enum('stanford')
+      # If access is "location-based", which location should have access.
+      attribute :readLocation, Types::Strict::String.optional.enum('').meta(omittable: true)
+      attribute :controlledDigitalLending, Types::Strict::Bool.enum(false).meta(omittable: true)
+    end
+  end
+end

data/lib/cocina/models/version.rb

@@ -2,6 +2,6 @@
 
 module Cocina
   module Models
-    VERSION = '0.58.2'
+    VERSION = '0.59.0'
   end
 end

data/lib/cocina/models/world_access.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    class WorldAccess < Struct
+      # Access level.
+      attribute :access, Types::Strict::String.enum('world')
+      # Download access level.
+      attribute :download, Types::Strict::String.enum('none', 'stanford', 'world')
+      # If access is "location-based", which location should have access.
+      attribute :readLocation, Types::Strict::String.optional.enum('').meta(omittable: true)
+      attribute :controlledDigitalLending, Types::Strict::Bool.enum(false).meta(omittable: true)
+    end
+  end
+end

data/openapi.yml

@@ -94,41 +94,16 @@ paths:
 components:
   schemas:
     Access:
-      description: Access metadata for collections
       type: object
-      additionalProperties: false
-      properties:
-        access:
-          description: Access level
-          type: string
-          enum:
-            - 'world'
-            - 'stanford'
-            - 'location-based'
-            - 'citation-only'
-            - 'dark'
-          default: 'dark'
-        copyright:
-          description: The human readable copyright statement that applies
-          example: Copyright World Trade Organization
-          type: string
-        readLocation:
-          description: If access is "location-based", which location should have access.
-          type: string
-          enum:
-            - 'spec'
-            - 'music'
-            - 'ars'
-            - 'art'
-            - 'hoover'
-            - 'm&m'
-        useAndReproductionStatement:
-          description: The human readable use and reproduction statement that applies
-          example: Property rights reside with the repository. Literary rights reside with the creators of the documents or their heirs. To obtain permission to publish or reproduce, please contact the Public Services Librarian of the Dept. of Special Collections (http://library.stanford.edu/spc).
-          type: string
-        license:
-          description: The license governing reuse of the Collection. Should be an IRI for known licenses (i.e. CC, RightsStatement.org URI, etc.).
-          type: string
+      oneOf:
+        # Being first, makes DarkAccess the default.
+        - $ref: '#/components/schemas/DarkAccess'
+        - $ref: '#/components/schemas/CitationOnlyAccess'
+        - $ref: '#/components/schemas/ControlledDigitalLendingAccess'
+        - $ref: '#/components/schemas/LocationBasedAccess'
+        - $ref: '#/components/schemas/LocationBasedDownloadAccess'
+        - $ref: '#/components/schemas/StanfordAccess'
+        - $ref: '#/components/schemas/WorldAccess'
     AccessRole:
       description: Access role conferred by an AdminPolicy to objects within it. (used by Argo)
       type: object
@@ -353,6 +328,33 @@ components:
       type: string
       pattern: '^[0-9]+-[0-9]+$'
       example: 6772719-1001
+    CitationOnlyAccess:
+      type: object
+      properties:
+        access:
+          description: Access level.
+          type: string
+          enum:
+            - citation-only
+        download:
+          description: Download access level.
+          type: string
+          enum:
+            - 'none'
+        readLocation:
+          description: If access is "location-based", which location should have access.
+          type: string
+          nullable: true
+          enum:
+            - null
+        controlledDigitalLending:
+          type: boolean
+          default: false
+          enum:
+            - false
+      required:
+        - access
+        - download
     Collection:
       description: A group of Digital Repository Objects that indicate some type of conceptual grouping within the domain that is worth reusing across the system.
       type: object
@@ -377,7 +379,7 @@ components:
           description: Version for the Collection within SDR.
           type: integer
         access:
-          $ref: '#/components/schemas/Access'
+          $ref: '#/components/schemas/CollectionAccess'
         administrative:
           $ref: '#/components/schemas/Administrative'
         description:
@@ -390,6 +392,29 @@ components:
         - type
         - version
         - access
+    CollectionAccess:
+      description: Access metadata for collections
+      type: object
+      additionalProperties: false
+      properties:
+        access:
+          description: Access level
+          type: string
+          enum:
+            - 'world'
+            - 'dark'
+          default: 'dark'
+        copyright:
+          description: The human readable copyright statement that applies
+          example: Copyright World Trade Organization
+          type: string
+        useAndReproductionStatement:
+          description: The human readable use and reproduction statement that applies
+          example: Property rights reside with the repository. Literary rights reside with the creators of the documents or their heirs. To obtain permission to publish or reproduce, please contact the Public Services Librarian of the Dept. of Special Collections (http://library.stanford.edu/spc).
+          type: string
+        license:
+          description: The license governing reuse of the Collection. Should be an IRI for known licenses (i.e. CC, RightsStatement.org URI, etc.).
+          type: string
     CollectionIdentification:
       type: object
       additionalProperties: false
@@ -442,6 +467,60 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/DescriptiveParallelContributor"
+    ControlledDigitalLendingAccess:
+      type: object
+      properties:
+        access:
+          description: Access level.
+          type: string
+          enum:
+            - stanford
+        download:
+          description: Download access level.
+          type: string
+          enum:
+            - none
+        readLocation:
+          description: If access is "location-based", which location should have access.
+          type: string
+          nullable: true
+          enum:
+            - null
+        controlledDigitalLending:
+          description: Available for controlled digital lending.
+          type: boolean
+          default: false
+      required:
+        - access
+        - download
+        - controlledDigitalLending
+    DarkAccess:
+      type: object
+      properties:
+        access:
+          description: Access level.
+          type: string
+          default: 'dark'
+          enum:
+            - dark
+        download:
+          description: Download access level.
+          type: string
+          default: 'none'
+          enum:
+            - 'none'
+        readLocation:
+          description: If access is "location-based", which location should have access.
+          type: string
+          nullable: true
+          default: null
+          enum:
+            - null
+        controlledDigitalLending:
+          type: boolean
+          default: false
+          enum:
+            - false
     Description:
       type: object
       additionalProperties: false
@@ -848,60 +927,23 @@ components:
     DROAccess:
       type: object
       additionalProperties: false
-      properties:
-        access:
-          type: string
-          enum:
-            - 'world'
-            - 'stanford'
-            - 'location-based'
-            - 'citation-only'
-            - 'dark'
-          default: 'dark'
-        controlledDigitalLending:
-          description: Available for controlled digital lending.
-          type: boolean
-          default: false
-        copyright:
-          description: The human readable copyright statement that applies
-          example: Copyright World Trade Organization
-          type: string
-        embargo:
-          $ref: '#/components/schemas/Embargo'
-        download:
-          description: >
-            Download access level. This is used in the transition from Fedora as
-            a way to set a default download level at registration that is copied
-            down to all the files.
-
-          type: string
-          enum:
-            - 'world'
-            - 'stanford'
-            - 'location-based'
-            - 'none'
-          default: 'none'
-        readLocation:
-          description: >
-            If access is "location-based", which location should have access.
-            This is used in the transition from Fedora as a way to set a default
-            readLocation at registration that is copied down to all the files.
-
-          type: string
-          enum:
-            - 'spec'
-            - 'music'
-            - 'ars'
-            - 'art'
-            - 'hoover'
-            - 'm&m'
-        useAndReproductionStatement:
-          description: The human readable use and reproduction statement that applies
-          example: Property rights reside with the repository. Literary rights reside with the creators of the documents or their heirs. To obtain permission to publish or reproduce, please contact the Public Services Librarian of the Dept. of Special Collections (http://library.stanford.edu/spc).
-          type: string
-        license:
-          description: The license governing reuse of the DRO. Should be an IRI for known licenses (i.e. CC, RightsStatement.org URI, etc.).
-          type: string
+      allOf:
+        - $ref: "#/components/schemas/Access"
+        - type: object
+          properties:
+            copyright:
+              description: The human readable copyright statement that applies
+              example: Copyright World Trade Organization
+              type: string
+            embargo:
+              $ref: '#/components/schemas/Embargo'
+            useAndReproductionStatement:
+              description: The human readable use and reproduction statement that applies
+              example: Property rights reside with the repository. Literary rights reside with the creators of the documents or their heirs. To obtain permission to publish or reproduce, please contact the Public Services Librarian of the Dept. of Special Collections (http://library.stanford.edu/spc).
+              type: string
+            license:
+              description: The license governing reuse of the DRO. Should be an IRI for known licenses (i.e. CC, RightsStatement.org URI, etc.).
+              type: string
     DROStructural:
       description: Structural metadata
       type: object
@@ -932,28 +974,21 @@ components:
     Embargo:
       type: object
       additionalProperties: false
-      properties:
-        releaseDate:
-          description: Date when the Collection is released from an embargo.
-          type: string
-          format: date-time
-          example: '2029-06-22T07:00:00.000+00:00'
-        access:
-          description: Access level that applies when embargo expires.
-          type: string
-          enum:
-            - world
-            - stanford
-            - location-based
-            - citation-only
-            - dark
-        useAndReproductionStatement:
-          description: The human readable use and reproduction statement that applies when the embargo expires.
-          example: These materials are in the public domain.
-          type: string
-      required:
-        - releaseDate
-        - access
+      allOf:
+        - $ref: "#/components/schemas/Access"
+        - type: object
+          properties:
+            releaseDate:
+              description: Date when the Collection is released from an embargo.
+              type: string
+              format: date-time
+              example: '2029-06-22T07:00:00.000+00:00'
+            useAndReproductionStatement:
+              description: The human readable use and reproduction statement that applies when the embargo expires.
+              example: These materials are in the public domain.
+              type: string
+          required:
+            - releaseDate
     Event:
       description: Property model for describing events in the history of the resource.
       type: object
@@ -1056,40 +1091,14 @@ components:
       description: Access metadata for files
       type: object
       additionalProperties: false
-      properties:
-        access:
-          description: Access level
-          type: string
-          enum:
-            - 'world'
-            - 'stanford'
-            - 'location-based'
-            - 'citation-only'
-            - 'dark'
-          default: 'dark'
-        controlledDigitalLending:
-          description: Available for controlled digital lending.
-          type: boolean
-          default: false
-        download:
-          description: Download access level for a file
-          type: string
-          enum:
-            - 'world'
-            - 'stanford'
-            - 'location-based'
-            - 'none'
-          default: 'none'
-        readLocation:
-          description: If access is "location-based", which location should have access.
-          type: string
-          enum:
-            - 'spec'
-            - 'music'
-            - 'ars'
-            - 'art'
-            - 'hoover'
-            - 'm&m'
+      oneOf:
+        # Being first, makes DarkAccess the default.
+        - $ref: '#/components/schemas/DarkAccess'
+        - $ref: '#/components/schemas/ControlledDigitalLendingAccess'
+        - $ref: '#/components/schemas/LocationBasedAccess'
+        - $ref: '#/components/schemas/LocationBasedDownloadAccess'
+        - $ref: '#/components/schemas/StanfordAccess'
+        - $ref: '#/components/schemas/WorldAccess'
     FileAdministrative:
       type: object
       additionalProperties: false
@@ -1247,6 +1256,72 @@ components:
         valueLanguage:
           # description: present for mapping to additional schemas in the future and for consistency but not otherwise used
           $ref: "#/components/schemas/DescriptiveValueLanguage"
+    LocationBasedAccess:
+      type: object
+      properties:
+        access:
+          description: Access level.
+          type: string
+          enum:
+            - location-based
+        download:
+          description: Download access level.
+          type: string
+          enum:
+            - location-based
+            - none
+        readLocation:
+          description: If access is "location-based", which location should have access.
+          type: string
+          enum:
+            - 'spec'
+            - 'music'
+            - 'ars'
+            - 'art'
+            - 'hoover'
+            - 'm&m'
+        controlledDigitalLending:
+          type: boolean
+          default: false
+          enum:
+            - false
+      required:
+        - access
+        - download
+        - readLocation
+    LocationBasedDownloadAccess:
+      type: object
+      properties:
+        access:
+          description: Access level.
+          type: string
+          enum:
+            - stanford
+            - world
+        download:
+          description: Download access level.
+          type: string
+          enum:
+            - location-based
+        readLocation:
+          description: If access is "location-based", which location should have access.
+          type: string
+          enum:
+            - 'spec'
+            - 'music'
+            - 'ars'
+            - 'art'
+            - 'hoover'
+            - 'm&m'
+        controlledDigitalLending:
+          type: boolean
+          default: false
+          enum:
+            - false
+      required:
+        - access
+        - download
+        - readLocation
     MessageDigest:
       description: The output of the message digest algorithm.
       type: object
@@ -1424,7 +1499,7 @@ components:
         version:
           type: integer
         access:
-          $ref: '#/components/schemas/Access'
+          $ref: '#/components/schemas/CollectionAccess'
         administrative:
           $ref: '#/components/schemas/Administrative'
         description:
@@ -1704,3 +1779,59 @@ components:
             - type: object
               required:
                 - valueAt
+    StanfordAccess:
+      type: object
+      properties:
+        access:
+          description: Access level.
+          type: string
+          enum:
+            - stanford
+        download:
+          description: Download access level.
+          type: string
+          enum:
+            - stanford
+        readLocation:
+          description: If access is "location-based", which location should have access.
+          type: string
+          nullable: true
+          enum:
+            - null
+        controlledDigitalLending:
+          type: boolean
+          default: false
+          enum:
+            - false
+      required:
+        - access
+        - download
+    WorldAccess:
+      type: object
+      properties:
+        access:
+          description: Access level.
+          type: string
+          enum:
+            - world
+        download:
+          description: Download access level.
+          type: string
+          enum:
+            - none
+            - stanford
+            - world
+        readLocation:
+          description: If access is "location-based", which location should have access.
+          type: string
+          nullable: true
+          enum:
+            - null
+        controlledDigitalLending:
+          type: boolean
+          default: false
+          enum:
+            - false
+      required:
+        - access
+        - download

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cocina-models
 version: !ruby/object:Gem::Version
-  version: 0.58.2
+  version: 0.59.0
 platform: ruby
 authors:
 - Justin Coyne
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-03-31 00:00:00.000000000 Z
+date: 2021-04-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -265,9 +265,13 @@ files:
 - lib/cocina/models/catalog_link.rb
 - lib/cocina/models/catkey_barcode.rb
 - lib/cocina/models/checkable.rb
+- lib/cocina/models/citation_only_access.rb
 - lib/cocina/models/collection.rb
+- lib/cocina/models/collection_access.rb
 - lib/cocina/models/collection_identification.rb
 - lib/cocina/models/contributor.rb
+- lib/cocina/models/controlled_digital_lending_access.rb
+- lib/cocina/models/dark_access.rb
 - lib/cocina/models/description.rb
 - lib/cocina/models/descriptive_access_metadata.rb
 - lib/cocina/models/descriptive_admin_metadata.rb
@@ -294,6 +298,8 @@ files:
 - lib/cocina/models/geographic.rb
 - lib/cocina/models/identification.rb
 - lib/cocina/models/language.rb
+- lib/cocina/models/location_based_access.rb
+- lib/cocina/models/location_based_download_access.rb
 - lib/cocina/models/message_digest.rb
 - lib/cocina/models/presentation.rb
 - lib/cocina/models/related_resource.rb
@@ -311,10 +317,12 @@ files:
 - lib/cocina/models/source_id.rb
 - lib/cocina/models/standard.rb
 - lib/cocina/models/standard_barcode.rb
+- lib/cocina/models/stanford_access.rb
 - lib/cocina/models/title.rb
 - lib/cocina/models/validator.rb
 - lib/cocina/models/version.rb
 - lib/cocina/models/vocab.rb
+- lib/cocina/models/world_access.rb
 - openapi.yml
 homepage: https://github.com/sul-dlss/cocina-models
 licenses: []
@@ -334,7 +342,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.0.3
 signing_key:
 specification_version: 4
 summary: Data models for the SDR