cocina-models 0.36.0 → 0.40.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f64b937df8c8d8c7bbd64af57d587e27843ebcd7e751ea4caff887aaa78c7a1
-  data.tar.gz: b697ab2535648dd6d1520f35da839e599756e7c49bbc2803d17a5d6e2db9307d
+  metadata.gz: b1a41a02c7e3c3d58b65f4b94e4afdbc885795920eee91fa83f87374a207c0c1
+  data.tar.gz: 3c70761dd272739012387d78df18c69d114ab5a152d79283131f8d727112dcb9
 SHA512:
-  metadata.gz: c67039d09d1d04e7bba5aaf0199402e5e1e0b9008b56a268735f59d4d61bd92f5c6e17f0edaf8625102f5e7bfd25e7cc66b4e58e51193e811bf2635b43ff21cc
-  data.tar.gz: d7eeeccbc2a215cdee206b746bda7e38e7c86fca21b5c92f40057c5ffa760494cc539490dd35734314e82506f0ad922ae15f68bcf414034d9ce2fad06375397c
+  metadata.gz: e7f56d6aa41f0d13d2dcf17a2aef82354b566025caf04ffff84b2857fabfcc8c703c16f3aae00cf43c4654922f7b9240ededef6366ed9b111b2b4690f5a11fd2
+  data.tar.gz: b452f06a8f0525035a0699e74345b8bd1fb7f96d5b3f9cfbd996f1f65bd99b82d7ffbd9fa71cd2a5c32e60ef8731df159833b2bae98070ddf9f40803316b3caf

data/.rubocop_todo.yml

@@ -1,18 +1,25 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2020-03-06 16:50:50 -0800 using RuboCop version 0.74.0.
+# on 2020-09-08 19:05:09 UTC using RuboCop version 0.89.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
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 4
-Metrics/AbcSize:
-  Max: 37
+# Offense count: 1
+# Configuration parameters: AllowedMethods.
+# AllowedMethods: present?, blank?, presence, try, try!
+Lint/SafeNavigationChain:
+  Exclude:
+    - 'lib/cocina/generator/schema_base.rb'
+
+# Offense count: 1
+# Configuration parameters: IgnoredMethods.
+Metrics/CyclomaticComplexity:
+  Max: 8
 
-# Offense count: 3
-# Configuration parameters: Max.
-RSpec/ExampleLength:
+# Offense count: 1
+# Configuration parameters: MinBodyLength.
+Style/GuardClause:
   Exclude:
-    - 'spec/cocina/models/dro_shared_examples.rb'
-    - 'spec/cocina/models/file_set_shared_examples.rb'
+    - 'lib/cocina/generator/schema_base.rb'

data/README.md

@@ -32,6 +32,27 @@ The generator is tested via its output when run against `openapi.yml`, viz., the
 
 Beyond what is necessary to test the generator, the Cocina model classes are not tested, i.e., they are assumed to be as specified in `openapi.yml`.
 
+## Releasing
+
+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.
+
+### Dependent Services
+
+Once the above listed gems are updated all the following services that use cocina-models should be updated and released at the same time:
+
+* sul-dlss/sdr-api
+* sul-dlss/dor-services-app
+* sul-dlss/google-books
+* sul-dlss/common-accessioning
+* sul-dlss/argo
+* sul-dlss/pre-assembly
+
 ## Using this gem
 
 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`.

data/docs/maps/DRO.json

@@ -81,6 +81,10 @@
           "description": "The human readable copyright statement that applies to the DRO.",
           "type": "string"
         },
+        "controlledDigitalLending": {
+          "description": "If the object is available for controlled digital lending.",
+          "type": "boolean"
+        },
         "download": {
           "description": "Download level for the DRO metadata.",
           "type": "string",
@@ -294,8 +298,11 @@
           }
         },
         "isMemberOf": {
-          "description": "Collection that this DRO is a member of",
-          "type": "string"
+          "description": "Collections that this DRO is a member of",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
         },
         "isTargetOf": {
           "description": "An Annotation instance that applies to the DRO.",

data/lib/cocina/generator/datatype.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Generator
+    # Class for generating from an openapi schema
+    class Datatype < SchemaBase
+      def generate
+        <<~RUBY
+          # frozen_string_literal: true
+
+          module Cocina
+            module Models
+              #{name} = Types::String.constrained(
+                format: /#{schema_doc.pattern}/i
+              )
+            end
+          end
+        RUBY
+      end
+    end
+  end
+end

data/lib/cocina/generator/generator.rb

@@ -56,9 +56,14 @@ module Cocina
 
       def schema_for(schema_name)
         schema_doc = schemas[schema_name]
-        return nil if schema_doc.nil? || schema_doc.type != 'object'
+        return nil if schema_doc.nil?
 
-        Schema.new(schema_doc)
+        case schema_doc.type
+        when 'object'
+          Schema.new(schema_doc)
+        when 'string'
+          Datatype.new(schema_doc)
+        end
       end
 
       def generate_for(schema)

data/lib/cocina/generator/schema_base.rb

@@ -54,7 +54,11 @@ module Cocina
         when 'boolean'
           'Strict::Bool'
         else
-          raise "#{schema_doc.type} not supported"
+          if doc.one_of&.map(&:type).all? { |o| %w[integer string].include?(o) }
+            'Nominal::Any'
+          else
+            raise "#{schema_doc.type} not supported"
+          end
         end
       end
 

data/lib/cocina/models/descriptive_basic_value.rb

@@ -5,8 +5,8 @@ module Cocina
     class DescriptiveBasicValue < Struct
       attribute :structuredValue, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
       attribute :parallelValue, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
-      # String value of the descriptive element.
-      attribute :value, Types::Strict::String.meta(omittable: true)
+      # String or integer value of the descriptive element.
+      attribute :value, Types::Nominal::Any.meta(omittable: true)
       # Type of value provided by the descriptive element.
       attribute :type, Types::Strict::String.meta(omittable: true)
       # Status of the descriptive element value relative to other instances of the element.
@@ -23,6 +23,7 @@ module Cocina
       # A term providing information about the circumstances of the statement (e.g., approximate dates).
       attribute :qualifier, Types::Strict::String.meta(omittable: true)
       attribute :note, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
+      attribute :valueLanguage, DescriptiveValueLanguage.optional.meta(omittable: true)
     end
   end
 end

data/lib/cocina/models/descriptive_value.rb

@@ -5,8 +5,8 @@ module Cocina
     class DescriptiveValue < Struct
       attribute :structuredValue, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
       attribute :parallelValue, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
-      # String value of the descriptive element.
-      attribute :value, Types::Strict::String.meta(omittable: true)
+      # String or integer value of the descriptive element.
+      attribute :value, Types::Nominal::Any.meta(omittable: true)
       # Type of value provided by the descriptive element.
       attribute :type, Types::Strict::String.meta(omittable: true)
       # Status of the descriptive element value relative to other instances of the element.
@@ -23,6 +23,7 @@ module Cocina
       # A term providing information about the circumstances of the statement (e.g., approximate dates).
       attribute :qualifier, Types::Strict::String.meta(omittable: true)
       attribute :note, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
+      attribute :valueLanguage, DescriptiveValueLanguage.optional.meta(omittable: true)
       attribute :appliesTo, Types::Strict::Array.of(DescriptiveBasicValue).meta(omittable: true)
     end
   end

data/lib/cocina/models/descriptive_value_language.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    class DescriptiveValueLanguage < Struct
+      # Code representing the standard or encoding.
+      attribute :code, Types::Strict::String.meta(omittable: true)
+      # URI for the standard or encoding.
+      attribute :uri, Types::Strict::String.meta(omittable: true)
+      # String describing the standard or encoding.
+      attribute :value, Types::Strict::String.meta(omittable: true)
+      attribute :note, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
+      attribute :source, Source.optional.meta(omittable: true)
+      attribute :valueScript, Standard.optional.meta(omittable: true)
+    end
+  end
+end

data/lib/cocina/models/descriptive_value_required.rb

@@ -5,8 +5,8 @@ module Cocina
     class DescriptiveValueRequired < Struct
       attribute :structuredValue, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
       attribute :parallelValue, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
-      # String value of the descriptive element.
-      attribute :value, Types::Strict::String.meta(omittable: true)
+      # String or integer value of the descriptive element.
+      attribute :value, Types::Nominal::Any.meta(omittable: true)
       # Type of value provided by the descriptive element.
       attribute :type, Types::Strict::String.meta(omittable: true)
       # Status of the descriptive element value relative to other instances of the element.
@@ -23,6 +23,7 @@ module Cocina
       # A term providing information about the circumstances of the statement (e.g., approximate dates).
       attribute :qualifier, Types::Strict::String.meta(omittable: true)
       attribute :note, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
+      attribute :valueLanguage, DescriptiveValueLanguage.optional.meta(omittable: true)
       attribute :appliesTo, Types::Strict::Array.of(DescriptiveBasicValue).meta(omittable: true)
     end
   end

data/lib/cocina/models/dro_structural.rb

@@ -5,8 +5,7 @@ module Cocina
     class DROStructural < Struct
       attribute :contains, Types::Strict::Array.of(FileSet).meta(omittable: true)
       attribute :hasMemberOrders, Types::Strict::Array.of(Sequence).meta(omittable: true)
-      # example: druid:bc123df4567
-      attribute :isMemberOf, Types::Strict::String.meta(omittable: true)
+      attribute :isMemberOf, Types::Strict::Array.of(Druid).meta(omittable: true)
       # Agreement that covers the deposit of the DRO into SDR.
       attribute :hasAgreement, Types::Strict::String.meta(omittable: true)
     end

data/lib/cocina/models/druid.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    Druid = Types::String.constrained(
+      format: /^druid:[b-df-hjkmnp-tv-z]{2}[0-9]{3}[b-df-hjkmnp-tv-z]{2}[0-9]{4}$/i
+    )
+  end
+end

data/lib/cocina/models/file.rb

@@ -24,7 +24,7 @@ module Cocina
       # Use for the File.
       attribute :use, Types::Strict::String.meta(omittable: true)
       attribute :hasMessageDigests, Types::Strict::Array.of(MessageDigest).default([].freeze)
-      attribute(:access, Access.default { Access.new })
+      attribute(:access, FileAccess.default { FileAccess.new })
       attribute(:administrative, FileAdministrative.default { FileAdministrative.new })
       attribute :presentation, Presentation.optional.meta(omittable: true)
     end

data/lib/cocina/models/file_access.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+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)
+      # 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)
+    end
+  end
+end

data/lib/cocina/models/identification.rb

@@ -3,7 +3,7 @@
 module Cocina
   module Models
     class Identification < Struct
-      # Unique identifier in some other system. This is because a large proportion of what is deposited in SDR, historically and currently, are representations of objects that are also represented in other systems. For example, digitized paper and A/V collections have physical manifestations, and those physical objects are managed in systems that have their own identifiers. Similarly, books have barcodes, archival materials have collection numbers and physical locations, etc. The sourceId allows determining if an item has been deposited before and where to look for the original item if you're looking at its SDR representation.
+      # Unique identifier in some other system. This is because a large proportion of what is deposited in SDR, historically and currently, are representations of objects that are also represented in other systems. For example, digitized paper and A/V collections have physical manifestations, and those physical objects are managed in systems that have their own identifiers. Similarly, books have barcodes, archival materials have collection numbers and physical locations, etc. The sourceId allows determining if an item has been deposited before and where to look for the original item if you're looking at its SDR representation. The format is: "namespace:identifier"
 
       # example: sul:PC0170_s3_Fiesta_Bowl_2012-01-02_210609_2026
       attribute :sourceId, Types::Strict::String.meta(omittable: true)

data/lib/cocina/models/language.rb

@@ -5,8 +5,8 @@ module Cocina
     class Language < Struct
       attribute :structuredValue, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
       attribute :parallelValue, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
-      # String value of the descriptive element.
-      attribute :value, Types::Strict::String.meta(omittable: true)
+      # String or integer value of the descriptive element.
+      attribute :value, Types::Nominal::Any.meta(omittable: true)
       # Type of value provided by the descriptive element.
       attribute :type, Types::Strict::String.meta(omittable: true)
       # Status of the descriptive element value relative to other instances of the element.
@@ -23,6 +23,7 @@ module Cocina
       # A term providing information about the circumstances of the statement (e.g., approximate dates).
       attribute :qualifier, Types::Strict::String.meta(omittable: true)
       attribute :note, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
+      attribute :valueLanguage, DescriptiveValueLanguage.optional.meta(omittable: true)
       attribute :appliesTo, Types::Strict::Array.of(DescriptiveBasicValue).meta(omittable: true)
       attribute :script, DescriptiveValue.optional.meta(omittable: true)
     end

data/lib/cocina/models/request_dro_structural.rb

@@ -5,8 +5,7 @@ module Cocina
     class RequestDROStructural < Struct
       attribute :contains, Types::Strict::Array.of(RequestFileSet).meta(omittable: true)
       attribute :hasMemberOrders, Types::Strict::Array.of(Sequence).meta(omittable: true)
-      # example: druid:bc123df4567
-      attribute :isMemberOf, Types::Strict::String.meta(omittable: true)
+      attribute :isMemberOf, Types::Strict::Array.of(Druid).meta(omittable: true)
       attribute :hasAgreement, Types::Strict::String.meta(omittable: true)
     end
   end

data/lib/cocina/models/request_file.rb

@@ -16,7 +16,7 @@ module Cocina
       attribute :externalIdentifier, Types::Strict::String.meta(omittable: true)
       attribute :use, Types::Strict::String.meta(omittable: true)
       attribute :hasMessageDigests, Types::Strict::Array.of(MessageDigest).default([].freeze)
-      attribute(:access, Access.default { Access.new })
+      attribute(:access, FileAccess.default { FileAccess.new })
       attribute(:administrative, FileAdministrative.default { FileAdministrative.new })
       attribute :presentation, Presentation.optional.meta(omittable: true)
     end

data/lib/cocina/models/request_identification.rb

@@ -3,7 +3,7 @@
 module Cocina
   module Models
     class RequestIdentification < Struct
-      # Unique identifier in some other system. This is because a large proportion of what is deposited in SDR, historically and currently, are representations of objects that are also represented in other systems. For example, digitized paper and A/V collections have physical manifestations, and those physical objects are managed in systems that have their own identifiers. Similarly, books have barcodes, archival materials have collection numbers and physical locations, etc. The sourceId allows determining if an item has been deposited before and where to look for the original item if you're looking at its SDR representation.
+      # Unique identifier in some other system. This is because a large proportion of what is deposited in SDR, historically and currently, are representations of objects that are also represented in other systems. For example, digitized paper and A/V collections have physical manifestations, and those physical objects are managed in systems that have their own identifiers. Similarly, books have barcodes, archival materials have collection numbers and physical locations, etc. The sourceId allows determining if an item has been deposited before and where to look for the original item if you're looking at its SDR representation. The format is: "namespace:identifier"
 
       # example: sul:PC0170_s3_Fiesta_Bowl_2012-01-02_210609_2026
       attribute :sourceId, Types::Strict::String

data/lib/cocina/models/source_id.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    SourceId = Types::String.constrained(
+      format: /^.+:.+$/i
+    )
+  end
+end

data/lib/cocina/models/version.rb

@@ -2,6 +2,6 @@
 
 module Cocina
   module Models
-    VERSION = '0.36.0'
+    VERSION = '0.40.1'
   end
 end

data/openapi.yml

@@ -94,7 +94,7 @@ paths:
 components:
   schemas:
     Access:
-      description: Access metadata
+      description: Access metadata for collections
       type: object
       additionalProperties: false
       properties:
@@ -430,8 +430,10 @@ components:
           additionalProperties: false
           properties:
             value:
-              description: String value of the descriptive element.
-              type: string
+              description: String or integer value of the descriptive element.
+              oneOf:
+              - type: string
+              - type: integer
             type:
               description: Type of value provided by the descriptive element.
               type: string
@@ -465,6 +467,8 @@ components:
               type: array
               items:
                 $ref: "#/components/schemas/DescriptiveValue"
+            valueLanguage:
+              $ref: "#/components/schemas/DescriptiveValueLanguage"
     DescriptiveParallelValue:
       description: Value model for multiple representations of the same information (e.g. in different languages).
       type: object
@@ -490,6 +494,18 @@ components:
       allOf:
         - $ref: "#/components/schemas/DescriptiveBasicValue"
         - $ref: "#/components/schemas/AppliesTo"
+    DescriptiveValueLanguage:
+      description: Language of the descriptive element value
+      type: object
+      additionalProperties: false
+      allOf:
+        - $ref: "#/components/schemas/Standard"
+        - type: object
+          properties:
+            valueScript:
+              $ref: '#/components/schemas/Standard'
+              # description: An alphabet or other notation used to represent a
+              #   language or other symbolic system of the descriptive element value.
     DescriptiveValueRequired:
       type: object
       additionalProperties: false
@@ -502,6 +518,9 @@ components:
             - type: object
               required:
                 - structuredValue
+            - type: object
+              required:
+                - parallelValue
     DRO:
       description: Domain-defined abstraction of a 'work'. Digital Repository Objects' abstraction is describable for our domain’s purposes, i.e. for management needs within our system.
       type: object
@@ -624,7 +643,10 @@ components:
           items:
             $ref: '#/components/schemas/Sequence'
         isMemberOf:
-          $ref: '#/components/schemas/Druid'
+          description: Collections that this DRO is a member of
+          type: array
+          items:
+            $ref: '#/components/schemas/Druid'
         hasAgreement:
           description: Agreement that covers the deposit of the DRO into SDR.
           type: string
@@ -725,7 +747,7 @@ components:
           items:
             $ref: '#/components/schemas/MessageDigest'
         access:
-          $ref: '#/components/schemas/Access'
+          $ref: '#/components/schemas/FileAccess'
         administrative:
           $ref: '#/components/schemas/FileAdministrative'
         presentation:
@@ -739,6 +761,44 @@ components:
         - access
         - administrative
         - hasMessageDigests
+    FileAccess:
+      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'
     FileAdministrative:
       type: object
       additionalProperties: false
@@ -801,22 +861,14 @@ components:
       additionalProperties: false
       properties:
         sourceId:
-          type: string
-          description: >
-            Unique identifier in some other system. This is because a large proportion of what is deposited in SDR,
-            historically and currently, are representations of objects that are also represented in other systems.
-            For example, digitized paper and A/V collections have physical manifestations, and those physical objects are managed
-            in systems that have their own identifiers. Similarly, books have barcodes, archival materials have collection numbers
-            and physical locations, etc. The sourceId allows determining if an item has been deposited before and where to
-            look for the original item if you're looking at its SDR representation.
-          example: 'sul:PC0170_s3_Fiesta_Bowl_2012-01-02_210609_2026'
+          $ref: '#/components/schemas/SourceId'
         catalogLinks:
           type: array
           items:
             $ref: '#/components/schemas/CatalogLink'
     Language:
       description: Languages, scripts, symbolic systems, and notations used in all
-        or part of a resource.
+        or part of a resource or its descriptive metadata.
       type: object
       additionalProperties: false
       allOf:
@@ -1058,7 +1110,10 @@ components:
           items:
             $ref: '#/components/schemas/Sequence'
         isMemberOf:
-          $ref: '#/components/schemas/Druid'
+          description: Collections that this DRO is a member of
+          type: array
+          items:
+            $ref: '#/components/schemas/Druid'
         hasAgreement:
           type: string
     RequestFile:
@@ -1088,7 +1143,7 @@ components:
           items:
             $ref: '#/components/schemas/MessageDigest'
         access:
-          $ref: '#/components/schemas/Access'
+          $ref: '#/components/schemas/FileAccess'
         administrative:
           $ref: '#/components/schemas/FileAdministrative'
         presentation:
@@ -1135,15 +1190,7 @@ components:
       additionalProperties: false
       properties:
         sourceId:
-          type: string
-          description: >
-            Unique identifier in some other system. This is because a large proportion of what is deposited in SDR,
-            historically and currently, are representations of objects that are also represented in other systems.
-            For example, digitized paper and A/V collections have physical manifestations, and those physical objects are managed
-            in systems that have their own identifiers. Similarly, books have barcodes, archival materials have collection numbers
-            and physical locations, etc. The sourceId allows determining if an item has been deposited before and where to
-            look for the original item if you're looking at its SDR representation.
-          example: 'sul:PC0170_s3_Fiesta_Bowl_2012-01-02_210609_2026'
+          $ref: '#/components/schemas/SourceId'
         catalogLinks:
           type: array
           items:
@@ -1187,6 +1234,17 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/DescriptiveValue"
+    SourceId:
+      type: string
+      pattern: '^.+:.+$'
+      description: >
+        Unique identifier in some other system. This is because a large proportion of what is deposited in SDR,
+        historically and currently, are representations of objects that are also represented in other systems.
+        For example, digitized paper and A/V collections have physical manifestations, and those physical objects are managed
+        in systems that have their own identifiers. Similarly, books have barcodes, archival materials have collection numbers
+        and physical locations, etc. The sourceId allows determining if an item has been deposited before and where to
+        look for the original item if you're looking at its SDR representation. The format is: "namespace:identifier"
+      example: 'sul:PC0170_s3_Fiesta_Bowl_2012-01-02_210609_2026'
     Standard:
       description: Property model for indicating the encoding, standard, or syntax
         to which a value conforms.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cocina-models
 version: !ruby/object:Gem::Version
-  version: 0.36.0
+  version: 0.40.1
 platform: ruby
 authors:
 - Justin Coyne
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-08-20 00:00:00.000000000 Z
+date: 2020-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -244,6 +244,7 @@ files:
 - docs/sampleETD/xn109qc9773_taco.json
 - exe/generator
 - lib/cocina/generator.rb
+- lib/cocina/generator/datatype.rb
 - lib/cocina/generator/generator.rb
 - lib/cocina/generator/schema.rb
 - lib/cocina/generator/schema_array.rb
@@ -269,13 +270,16 @@ files:
 - lib/cocina/models/descriptive_parallel_value.rb
 - lib/cocina/models/descriptive_structured_value.rb
 - lib/cocina/models/descriptive_value.rb
+- lib/cocina/models/descriptive_value_language.rb
 - lib/cocina/models/descriptive_value_required.rb
 - lib/cocina/models/dro.rb
 - lib/cocina/models/dro_access.rb
 - lib/cocina/models/dro_structural.rb
+- lib/cocina/models/druid.rb
 - lib/cocina/models/embargo.rb
 - lib/cocina/models/event.rb
 - lib/cocina/models/file.rb
+- lib/cocina/models/file_access.rb
 - lib/cocina/models/file_administrative.rb
 - lib/cocina/models/file_set.rb
 - lib/cocina/models/file_set_structural.rb
@@ -296,6 +300,7 @@ files:
 - lib/cocina/models/request_identification.rb
 - lib/cocina/models/sequence.rb
 - lib/cocina/models/source.rb
+- lib/cocina/models/source_id.rb
 - lib/cocina/models/standard.rb
 - lib/cocina/models/validator.rb
 - lib/cocina/models/version.rb