Add API credential fields to item data source

Add support for `valid_from`, `expires`, and `filename` fields in the `API_CREDENTIAL` category. Update documentation and internal descriptions to reflect these additions, ensuring consistent handling of API credential metadata.

Author: speto

docs/data-sources/item.md

@@ -34,7 +34,7 @@ data "onepassword_item" "example" {
 
 ### Read-Only
 
-- `category` (String) The category of the item. One of ["login" "password" "database" "secure_note" "document" "ssh_key"]
+- `category` (String) The category of the item. One of ["login" "password" "database" "secure_note" "document" "ssh_key" "credential"]
 - `credential` (String, Sensitive) API credential for this item.
 - `database` (String) (Only applies to the database category) The name of the database.
 - `file` (Block List) A list of files attached to the item. (see [below for nested schema](#nestedblock--file))
@@ -46,9 +46,10 @@ data "onepassword_item" "example" {
 - `public_key` (String) SSH Public Key for this item.
 - `section` (Block List) A list of custom sections in an item (see [below for nested schema](#nestedblock--section))
 - `tags` (List of String) An array of strings of the tags assigned to the item.
-- `type` (String) (Only applies to the database category) The type of database. One of ["db2" "filemaker" "msaccess" "mssql" "mysql" "oracle" "postgresql" "sqlite" "other"]
+- `type` (String) (Applies to the database and API credential categories) The type of database or API credential. For the database category, one of ["db2" "filemaker" "msaccess" "mssql" "mysql" "oracle" "postgresql" "sqlite" "other"]. For API credentials, it can be any string.
 - `url` (String) The primary URL for the item.
 - `username` (String) Username for this item.
+- `filename` (String) (Applies to the API credential category) Filename for this item.
 
 <a id="nestedblock--file"></a>
 ### Nested Schema for `file`

internal/provider/const.go

@@ -17,15 +17,19 @@ const (
 	tagsDescription       = "An array of strings of the tags assigned to the item."
 	usernameDescription   = "Username for this item."
 	passwordDescription   = "Password for this item."
-	credentialDescription = "API credential for this item."
 	noteValueDescription  = "Secure Note value."
 	publicKeyDescription  = "SSH Public Key for this item."
 	privateKeyDescription = "SSH Private Key for this item."
 
+	credentialDescription = "(Only applies to the API credential category) API credential for this item."
+	validFromDescription  = "(Only applies to the API credential category) The timestamp from which the API credential is valid."
+	expiresDescription    = "(Only applies to the API credential category) The timestamp when the API credential expires."
+	filenameDescription   = "(Only applies to the API credential category) The filename associated with the API credential."
+
 	dbHostnameDescription = "(Only applies to the database category) The address where the database can be found"
 	dbDatabaseDescription = "(Only applies to the database category) The name of the database."
 	dbPortDescription     = "(Only applies to the database category) The port the database is listening on."
-	dbTypeDescription     = "(Only applies to the database category) The type of database."
+	dbTypeDescription     = "(Only applies to database and API credential categories) For the database category"
 
 	sectionsDescription      = "A list of custom sections in an item"
 	sectionDescription       = "A custom section in an item that contains custom fields"
@@ -72,6 +76,7 @@ var (
 	dataSourceCategories = append(categories,
 		strings.ToLower(string(op.Document)),
 		strings.ToLower(string(op.SSHKey)),
+		strings.ToLower(string(op.ApiCredential)),
 	)
 
 	fieldPurposes = []string{

internal/provider/onepassword_item_data_source.go

@@ -48,6 +48,9 @@ type OnePasswordItemDataSourceModel struct {
 	Password   types.String                  `tfsdk:"password"`
 	NoteValue  types.String                  `tfsdk:"note_value"`
 	Credential types.String                  `tfsdk:"credential"`
+	Filename   types.String                  `tfsdk:"filename"`
+	ValidFrom  types.String                  `tfsdk:"valid_from"`
+	Expires    types.String                  `tfsdk:"expires"`
 	PublicKey  types.String                  `tfsdk:"public_key"`
 	PrivateKey types.String                  `tfsdk:"private_key"`
 	Section    []OnePasswordItemSectionModel `tfsdk:"section"`
@@ -176,6 +179,18 @@ func (d *OnePasswordItemDataSource) Schema(ctx context.Context, req datasource.S
 				Computed:            true,
 				Sensitive:           true,
 			},
+			"valid_from": schema.StringAttribute{
+				MarkdownDescription: validFromDescription,
+				Computed:            true,
+			},
+			"expires": schema.StringAttribute{
+				MarkdownDescription: expiresDescription,
+				Computed:            true,
+			},
+			"filename": schema.StringAttribute{
+				MarkdownDescription: filenameDescription,
+				Computed:            true,
+			},
 			"note_value": schema.StringAttribute{
 				MarkdownDescription: noteValueDescription,
 				Computed:            true,
@@ -377,6 +392,12 @@ func (d *OnePasswordItemDataSource) Read(ctx context.Context, req datasource.Rea
 					data.PrivateKey = types.StringValue(f.Value)
 				case "credential":
 					data.Credential = types.StringValue(f.Value)
+				case "valid_from":
+					data.ValidFrom = types.StringValue(f.Value)
+				case "expires":
+					data.Expires = types.StringValue(f.Value)
+				case "filename":
+					data.Filename = types.StringValue(f.Value)
 				}
 			}
 		}