@carrot-foundation/schemas 0.4.1 → 0.5.0

package/dist/index.cjs

@@ -42,9 +42,14 @@ var NonNegativeFloatSchema = zod.z.number().min(0).meta({
   description: "Floating-point number that is zero or positive",
   examples: [0, 45.2, 72.5]
 });
-var WeightKgSchema = NonNegativeFloatSchema.meta({
+var PositiveFloatSchema = zod.z.number().gt(0).meta({
+  title: "Positive Float",
+  description: "Floating-point number greater than zero",
+  examples: [0.1, 45.2, 72.5]
+});
+var WeightKgSchema = PositiveFloatSchema.meta({
   title: "Weight",
-  description: "Weight measurement in kilograms (kg)",
+  description: "Weight measurement in kilograms (kg), must be greater than zero",
   examples: [500.35, 3e3]
 });
 var PercentageSchema = NonNegativeFloatSchema.max(100).meta({
@@ -29410,22 +29415,27 @@ var CreditRetirementReceiptSummarySchema = SummaryBaseSchema.safeExtend({
   description: "Summary totals for the credit retirement including credit quantity, certificate count, and timestamp"
 });
 var ReceiptIdentitySchema = zod.z.strictObject({
-  name: NonEmptyStringSchema.max(100).meta({
+  name: NonEmptyStringSchema.max(100).optional().meta({
     title: "Identity Name",
     description: "Display name of the buyer or beneficiary on the receipt",
     examples: ["EcoTech Solutions Inc.", "Climate Action Corp"]
   }),
-  external_id: ExternalIdSchema.meta({
+  external_id: ExternalIdSchema.optional().meta({
     title: "Identity External ID",
     description: "Unique identifier for the buyer or beneficiary in the Carrot platform"
   }),
-  external_url: ExternalUrlSchema.meta({
+  external_url: ExternalUrlSchema.optional().meta({
     title: "Identity External URL",
     description: "Link to the buyer or beneficiary profile page on the Carrot platform"
   })
-}).meta({
+}).refine(
+  (value) => value.name !== void 0 || value.external_id !== void 0 || value.external_url !== void 0,
+  {
+    message: "identity must include at least one of: name, external_id, external_url"
+  }
+).meta({
   title: "Identity",
-  description: "Identity information for the buyer or beneficiary associated with this receipt"
+  description: "Identity information for the buyer or beneficiary associated with this receipt. All fields are optional, but at least one must be provided when the identity block is present."
 });
 function createReceiptCollectionSchema(params) {
   const { meta } = params;
@@ -29481,7 +29491,7 @@ function buildSchemaUrl(schemaPath) {
   return `${getSchemaBaseUrl()}/${cleanPath}`;
 }
 function getSchemaVersionOrDefault() {
-  return "0.4.1";
+  return "0.5.0";
 }
 
 // src/shared/schema-validation.ts
@@ -31474,11 +31484,11 @@ var CreditRetirementReceiptPurchaseReceiptAttributeSchema = NftAttributeSchema.s
 });
 var REQUIRED_CREDIT_RETIREMENT_RECEIPT_ATTRIBUTES = [
   CreditRetirementReceiptTotalCreditsAttributeSchema,
-  CreditRetirementReceiptBeneficiaryAttributeSchema,
   CreditRetirementReceiptRetirementDateAttributeSchema,
   CreditRetirementReceiptCertificatesAttributeSchema
 ];
 var CONDITIONAL_CREDIT_RETIREMENT_RECEIPT_ATTRIBUTES = [
+  CreditRetirementReceiptBeneficiaryAttributeSchema,
   CreditRetirementReceiptCreditHolderAttributeSchema,
   CreditRetirementReceiptPurchaseDateAttributeSchema,
   CreditRetirementReceiptPurchaseReceiptAttributeSchema
@@ -31493,11 +31503,10 @@ var CreditRetirementReceiptAttributesSchema = createOrderedAttributesSchema({
     ...DYNAMIC_CREDIT_RETIREMENT_RECEIPT_ATTRIBUTES
   ],
   title: "Credit Retirement Receipt NFT Attribute Array",
-  description: "Attributes for credit retirement receipts including per-credit breakdowns, totals, beneficiary, credit holder, retirement date, certificate count, and optional purchase info. Fixed required attributes: Total Credits Retired, Beneficiary, Retirement Date, Certificates Retired. Conditional attributes: Credit Holder (required when credit_holder.identity.name is provided), Purchase Date (optional, when purchase_receipt is present), Purchase Receipt (optional, when purchase_receipt is present). Dynamic attributes: Credit attributes (one per credit symbol in data.credits).",
+  description: "Attributes for credit retirement receipts including per-credit breakdowns, totals, beneficiary, credit holder, retirement date, certificate count, and optional purchase info. Fixed required attributes: Total Credits Retired, Retirement Date, Certificates Retired. Conditional attributes: Beneficiary (required when beneficiary.identity.name is provided), Credit Holder (required when credit_holder.identity.name is provided), Purchase Date (optional, when purchase_receipt is present), Purchase Receipt (optional, when purchase_receipt is present). Dynamic attributes: Credit attributes (one per credit symbol in data.credits).",
   uniqueBySelector: (attribute) => attribute.trait_type,
   requiredTraitTypes: [
     "Total Credits Retired",
-    "Beneficiary",
     "Retirement Date",
     "Certificates Retired"
   ]
@@ -31508,7 +31517,7 @@ var CreditRetirementReceiptBeneficiarySchema = zod.z.strictObject({
     title: "Retirement Beneficiary ID",
     description: "UUID identifying the beneficiary of the retirement (bytes16 normalized to UUID)"
   }),
-  identity: CreditRetirementReceiptIdentitySchema
+  identity: CreditRetirementReceiptIdentitySchema.optional()
 }).meta({
   title: "Beneficiary",
   description: "Beneficiary receiving the retirement benefit"
@@ -31728,7 +31737,7 @@ var CreditRetirementReceiptDataSchema = zod.z.strictObject({
 });
 var CreditRetirementReceiptIpfsSchemaMeta = {
   title: "CreditRetirementReceipt NFT IPFS Record",
-  description: "Complete CreditRetirementReceipt NFT IPFS record including retirement summary, beneficiary and credit holder details, credit breakdowns, certificate allocations, and NFT display attributes",
+  description: "Complete CreditRetirementReceipt NFT IPFS record including retirement summary, beneficiary and credit holder details (identity optional), credit breakdowns, certificate allocations, and NFT display attributes",
   $id: buildSchemaUrl(
     "credit-retirement-receipt/credit-retirement-receipt.schema.json"
   ),
@@ -31798,14 +31807,17 @@ var CreditRetirementReceiptIpfsSchema = NftIpfsSchema.safeExtend({
     missingMessage: 'Attribute "Certificates Retired" is required',
     mismatchMessage: 'Attribute "Certificates Retired" must match data.summary.total_certificates'
   });
-  validateAttributeValue({
-    ctx,
-    attributeByTraitType,
-    traitType: "Beneficiary",
-    expectedValue: String(data.beneficiary.identity.name),
-    missingMessage: 'Attribute "Beneficiary" is required',
-    mismatchMessage: 'Attribute "Beneficiary" must match beneficiary.identity.name'
-  });
+  const beneficiaryName = data.beneficiary.identity?.name;
+  if (beneficiaryName) {
+    validateAttributeValue({
+      ctx,
+      attributeByTraitType,
+      traitType: "Beneficiary",
+      expectedValue: String(beneficiaryName),
+      missingMessage: 'Attribute "Beneficiary" is required when beneficiary.identity.name is provided',
+      mismatchMessage: 'Attribute "Beneficiary" must match beneficiary.identity.name'
+    });
+  }
   const creditHolderName = data.credit_holder.identity?.name;
   if (creditHolderName) {
     validateAttributeValue({
@@ -32198,6 +32210,7 @@ exports.ParticipantIdHashSchema = ParticipantIdHashSchema;
 exports.ParticipantRoleSchema = ParticipantRoleSchema;
 exports.ParticipantSchema = ParticipantSchema;
 exports.PercentageSchema = PercentageSchema;
+exports.PositiveFloatSchema = PositiveFloatSchema;
 exports.PositiveIntegerSchema = PositiveIntegerSchema;
 exports.ReceiptIdentitySchema = ReceiptIdentitySchema;
 exports.RecordEnvironmentSchema = RecordEnvironmentSchema;