feat: Implement Pack Manifests

src/OrasProject.Oras/Exceptions/InvalidDateTimeFormatException.cs

@@ -0,0 +1,36 @@
+// Copyright The ORAS Authors.
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+using System;
+
+namespace OrasProject.Oras.Exceptions;
+
+/// <summary>
+/// InvalidDateTimeFormatException is thrown when a time format is invalid.
+/// </summary>
+public class InvalidDateTimeFormatException : FormatException
+{
+    public InvalidDateTimeFormatException()
+    {
+    }
+
+    public InvalidDateTimeFormatException(string? message)
+        : base(message)
+    {
+    }
+
+    public InvalidDateTimeFormatException(string? message, Exception? inner)
+        : base(message, inner)
+    {
+    }
+}

src/OrasProject.Oras/Exceptions/InvalidMediaTypeException.cs

@@ -0,0 +1,36 @@
+// Copyright The ORAS Authors.
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+using System;
+
+namespace OrasProject.Oras.Exceptions;
+
+/// <summary>
+/// InvalidMediaTypeException is thrown when media type is invalid.
+/// </summary>
+public class InvalidMediaTypeException : FormatException
+{
+    public InvalidMediaTypeException()
+    {
+    }
+
+    public InvalidMediaTypeException(string? message)
+        : base(message)
+    {
+    }
+
+    public InvalidMediaTypeException(string? message, Exception? inner)
+        : base(message, inner)
+    {
+    }
+}

src/OrasProject.Oras/Exceptions/MissingArtifactTypeException.cs

@@ -0,0 +1,36 @@
+// Copyright The ORAS Authors.
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+using System;
+
+namespace OrasProject.Oras.Exceptions;
+
+/// <summary>
+/// MissingArtifactTypeException is thrown when artifactType is not found in manifest.
+/// </summary>
+public class MissingArtifactTypeException : FormatException
+{
+    public MissingArtifactTypeException()
+    {
+    }
+
+    public MissingArtifactTypeException(string? message)
+        : base(message)
+    {
+    }
+
+    public MissingArtifactTypeException(string? message, Exception? inner)
+        : base(message, inner)
+    {
+    }
+}

src/OrasProject.Oras/Oci/Descriptor.cs

@@ -11,7 +11,10 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
+using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
+using System.Text;
 using System.Text.Json.Serialization;
 
 namespace OrasProject.Oras.Oci;
@@ -47,5 +50,19 @@ public class Descriptor
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
     public string? ArtifactType { get; set; }
 
+    public static Descriptor Create(Span<byte> data, string mediaType)
+    {
+        byte[] byteData = data.ToArray();
+        return new Descriptor
+        {
+            MediaType = mediaType,
+            Data = byteData,
+            Digest = OrasProject.Oras.Content.Digest.ComputeSHA256(byteData),
+            Size = byteData.Length
+        };
+    }
+
+    public static Descriptor Empty => Descriptor.Create(new byte[] { 0x7B, 0x7D }, OrasProject.Oras.Oci.MediaType.EmptyJson);  
+
     internal BasicDescriptor BasicDescriptor => new BasicDescriptor(MediaType, Digest, Size);
 }

src/OrasProject.Oras/PackManifestOptions.cs

@@ -0,0 +1,55 @@
+// Copyright The ORAS Authors.
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+using OrasProject.Oras.Oci;
+
+using System.Collections.Generic;
+using System.Threading;
+
+namespace OrasProject.Oras;
+
+public struct PackManifestOptions
+{
+    public static PackManifestOptions None { get; }
+
+    /// <summary>
+    /// Config references a configuration object for a container, by digest
+    /// For more details: https://github.com/opencontainers/image-spec/blob/v1.1.0/manifest.md#image-manifest-property-descriptions.
+    /// </summary>
+    public Descriptor Config { get; set; }
+
+    /// <summary>
+    /// Layers is an array of objects, and each object id a Content Descriptor (or simply Descriptor)
+    /// For more details: https://github.com/opencontainers/image-spec/blob/v1.1.0/manifest.md#image-manifest-property-descriptions.
+    /// </summary>
+    public IList<Descriptor>? Layers { get; set; }
+
+    /// <summary>
+    /// Subject is the subject of the manifest.
+    /// This option is invalid when PackManifestVersion is PackManifestVersion1_0.
+    /// </summary>
+    public Descriptor? Subject { get; set; }
+
+    /// <summary>
+    /// ManifestAnnotations is OPTIONAL property. It contains arbitrary metadata for the image manifest
+    /// and MUST use the annotation rules
+    /// </summary>
+    public IDictionary<string, string>? ManifestAnnotations { get; set; }
+
+    /// <summary>
+    /// ConfigAnnotations is the annotation map of the config descriptor.
+    /// This option is valid only when Config is null.
+    /// </summary>
+    public IDictionary<string, string>? ConfigAnnotations { get; set; }
+}
+