@carrot-foundation/schemas 0.2.3 → 0.3.0

package/dist/index.js

@@ -7,8 +7,8 @@ import canonicalize from 'canonicalize';
 // src/mass-id/mass-id.attributes.ts
 var NonEmptyStringSchema = z.string().min(1, "Cannot be empty").meta({
   title: "Non-Empty String",
-  description: "A string that contains at least one character",
-  examples: ["Example text", "Sample value"]
+  description: "A non-empty string (minimum one character)",
+  examples: ["example-value", "Hello World"]
 });
 var SlugSchema = NonEmptyStringSchema.regex(
   /^[a-z0-9-]+$/,
@@ -58,7 +58,8 @@ var PositiveIntegerSchema = z.number().int().min(1).meta({
 });
 var CreditAmountSchema = NonNegativeFloatSchema.meta({
   title: "Credit Amount",
-  description: "Amount of credits issued"
+  description: "Number of environmental impact credits issued, purchased, or retired",
+  examples: [1.5, 100, 2500.75]
 });
 var UsdcAmountSchema = NonNegativeFloatSchema.refine(
   (value) => {
@@ -28035,16 +28036,16 @@ var IsoCountrySubdivisionCodeSchema = z.string().regex(
   "Must be a valid Brazil subdivision code"
 ).meta({
   title: "Country Subdivision Code",
-  description: "Subdivision code following ISO 3166-2 standard",
-  examples: ["BR-AP", "BR-DF"]
+  description: "State or region code following the ISO 3166-2 standard (e.g., BR-SP for S\xE3o Paulo)",
+  examples: ["BR-SP", "BR-RS", "BR-AP", "BR-DF"]
 });
 var CitySchema = NonEmptyStringSchema.max(50).refine(
   (data) => BRAZIL_MUNICIPALITIES.some((municipality) => municipality.name === data),
   "Must be a valid Brazil municipality"
 ).meta({
   title: "City",
-  description: "City name",
-  examples: ["Bras\xEDlia", "S\xE3o Paulo"]
+  description: "Name of the Brazilian municipality where the activity takes place",
+  examples: ["Bras\xEDlia", "S\xE3o Paulo", "Carazinho", "Jundia\xED"]
 });
 var LatitudeSchema = z.number().min(-90).max(90).multipleOf(0.1).meta({
   title: "Latitude",
@@ -28111,7 +28112,7 @@ var UuidSchema = z.uuidv4().meta({
 });
 var ExternalIdSchema = UuidSchema.meta({
   title: "External ID",
-  description: "UUID identifier for external system references"
+  description: "UUID v4 identifier linking this IPFS record to its counterpart in the Carrot platform and other consuming systems"
 });
 var TokenIdSchema = NonEmptyStringSchema.regex(
   /^\d+$/,
@@ -28125,9 +28126,10 @@ var StringifiedTokenIdSchema = NonEmptyStringSchema.regex(
   /^#\d+$/,
   "Must match pattern #<token_id>"
 ).meta({
-  title: "Token ID",
-  description: "Token ID represented as #<token_id>",
-  example: "#123"
+  title: "Display Token ID",
+  description: "Human-readable token ID prefixed with # for display purposes (e.g., #456789)",
+  examples: ["#456789", "#1000000"],
+  example: "#456789"
 });
 var Sha256HashSchema = z.hash("sha256", {
   error: "Must be a SHA256 hash as 32-byte hex string"
@@ -28141,7 +28143,7 @@ var Sha256HashSchema = z.hash("sha256", {
 });
 var ParticipantIdHashSchema = Sha256HashSchema.meta({
   title: "Participant ID Hash",
-  description: "SHA-256 hash representing a participant identifier (SHA-256 hex string)",
+  description: "SHA-256 hash anonymizing a participant identity \u2014 used to link records without exposing personal data",
   examples: [
     "87f633634cc4b02f628685651f0a29b7bfa22a0bd841f725c6772dd00a58d489"
   ]
@@ -28216,8 +28218,8 @@ var RecordSchemaTypeSchema = z.enum([
   "Collection"
 ]).meta({
   title: "Schema Type",
-  description: "Type of schema in the Carrot ecosystem",
-  examples: ["MassID", "RecycledID", "GasID"]
+  description: "Identifies the record type within the Carrot ecosystem (e.g., MassID for waste tracking, GasID for prevented emissions certificates)",
+  examples: ["MassID", "GasID", "Credit", "CreditPurchaseReceipt"]
 });
 var CreditTokenNameSchema = z.enum(["Carrot Carbon (CH\u2084)", "Carrot Biowaste"]).meta({
   title: "Credit Token Name",
@@ -28236,12 +28238,12 @@ var CreditTokenSymbolSchema = z.enum(["C-CARB.CH4", "C-BIOW"]).meta({
 });
 var CreditTypeSchema = z.enum(["Biowaste", "Carbon (CH\u2084)"]).meta({
   title: "Credit Type",
-  description: "Type of credit issued",
+  description: "Category of environmental credit \u2014 indicates the impact pathway (biowaste diversion or methane prevention)",
   examples: ["Biowaste", "Carbon (CH\u2084)"]
 });
 var GasTypeSchema = z.enum(["Methane (CH\u2084)"]).meta({
   title: "Gas Type",
-  description: "Type of gas prevented",
+  description: "Greenhouse gas type whose emission was prevented through the waste management activity",
   examples: ["Methane (CH\u2084)"]
 });
 var VehicleTypeSchema = z.enum([
@@ -28257,8 +28259,8 @@ var VehicleTypeSchema = z.enum([
   "Truck"
 ]).meta({
   title: "Vehicle Type",
-  description: "Type of vehicle used for waste transportation operations",
-  examples: ["Truck"]
+  description: "Type of vehicle used to transport waste between collection and processing sites",
+  examples: ["Truck", "Motorcycle", "Cart"]
 });
 var ScaleTypeSchema = z.enum([
   "Bin Scale",
@@ -28273,18 +28275,18 @@ var ScaleTypeSchema = z.enum([
   "Weighbridge (Truck Scale)"
 ]).meta({
   title: "Scale Type",
-  description: "Type of scale used to weigh the load",
-  examples: ["Weighbridge (Truck Scale)"]
+  description: "Type of weighing equipment used to measure the waste load at a collection or processing site",
+  examples: ["Weighbridge (Truck Scale)", "Floor Scale"]
 });
 var WeighingCaptureMethodSchema = z.enum(["Digital", "Manual", "Photo (Scale + Cargo)", "Transport Manifest"]).meta({
   title: "Weighing Capture Method",
-  description: "Method used to capture weight data",
-  examples: ["Digital", "Manual"]
+  description: "How the weight measurement was recorded \u2014 digital readout, manual entry, photo evidence, or transport manifest",
+  examples: ["Digital", "Photo (Scale + Cargo)"]
 });
 var ContainerTypeSchema = z.enum(["Bag", "Bin", "Drum", "Pail", "Street Bin", "Truck", "Waste Box"]).meta({
   title: "Container Type",
-  description: "Type of container holding the waste",
-  examples: ["Bag", "Bin"]
+  description: "Type of container used to hold or transport the waste material",
+  examples: ["Bag", "Bin", "Truck"]
 });
 var CollectionSlugSchema = z.enum([
   "bold-innovators",
@@ -28293,7 +28295,7 @@ var CollectionSlugSchema = z.enum([
   "bold-brazil"
 ]).meta({
   title: "Collection Slug",
-  description: "URL-friendly identifier for a collection",
+  description: "URL-friendly identifier for an environmental credit collection, used in URIs and API references",
   examples: ["bold-cold-start-carazinho", "bold-brazil"]
 });
 var ParticipantRoleSchema = z.enum([
@@ -28313,7 +28315,7 @@ var ParticipantRoleSchema = z.enum([
 });
 var WasteTypeSchema = z.enum(["Organic"]).meta({
   title: "Waste Type",
-  description: "Category or type of waste material",
+  description: "Broad classification of the waste material being tracked (e.g., Organic)",
   examples: ["Organic"]
 });
 var WasteSubtypeSchema = z.enum([
@@ -28326,8 +28328,8 @@ var WasteSubtypeSchema = z.enum([
   "Wood and Wood Products"
 ]).meta({
   title: "Waste Subtype",
-  description: "Specific subcategory of waste within a waste type",
-  examples: ["Food, Food Waste and Beverages", "Domestic Sludge"]
+  description: "Detailed subcategory of the waste material, refining the broad waste type classification",
+  examples: ["Food, Food Waste and Beverages", "Garden, Yard and Park Waste"]
 });
 var CollectionNameSchema = z.enum([
   "BOLD Innovators",
@@ -28336,7 +28338,7 @@ var CollectionNameSchema = z.enum([
   "BOLD Brazil"
 ]).meta({
   title: "Collection Name",
-  description: "Display name of the collection",
+  description: "Human-readable display name for the environmental credit collection",
   examples: ["BOLD Cold Start - Carazinho", "BOLD Brazil"]
 });
 var MethodologyNameSchema = z.enum([
@@ -28362,7 +28364,7 @@ var MethodologySlugSchema = z.enum(["bold-recycling", "bold-carbon-ch4"]).meta({
 });
 var CertificateTypeSchema = z.enum(["GasID", "RecycledID"]).meta({
   title: "Certificate Type",
-  description: "Type of certificate (e.g., GasID, RecycledID)",
+  description: "Type of certificate \u2014 GasID for methane prevention, RecycledID for waste recycling",
   examples: ["GasID", "RecycledID"]
 });
 
@@ -28630,26 +28632,58 @@ var NftIpfsSchema = BaseIpfsSchema.safeExtend({
 });
 
 // src/shared/schemas/core/nft-name.schemas.ts
-var MassIDNameSchema = NonEmptyStringSchema.max(100).regex(
-  /^MassID #\d+ • .+ • .+t$/,
-  'Name must match format: "MassID #[token_id] \u2022 [waste_type] \u2022 [weight]t"'
-).meta({
+function buildNameSchemas(config) {
+  const {
+    prefix,
+    regexSuffix,
+    formatHint,
+    title,
+    description,
+    examples,
+    maxLength = 100
+  } = config;
+  const meta = { title, description, examples };
+  const schema = NonEmptyStringSchema.max(maxLength).regex(
+    new RegExp(`^${prefix} #\\d+${regexSuffix}$`),
+    `Name must match format: "${prefix} #[token_id] \u2022 ${formatHint}"`
+  ).meta(meta);
+  const createSchema = (tokenId) => NonEmptyStringSchema.max(maxLength).regex(
+    new RegExp(String.raw`^${prefix} #${tokenId}${regexSuffix}$`),
+    `Name must match format: "${prefix} #${tokenId} \u2022 ${formatHint}"`
+  ).meta(meta);
+  return { schema, createSchema };
+}
+function buildShortNameSchemas(config) {
+  const { prefix, title, description, examples, maxLength = 50 } = config;
+  const meta = { title, description, examples };
+  const schema = NonEmptyStringSchema.max(maxLength).regex(
+    new RegExp(`^${prefix} #\\d+$`),
+    `Short name must match format: "${prefix} #[token_id]"`
+  ).meta(meta);
+  const createSchema = (tokenId) => NonEmptyStringSchema.max(maxLength).refine(
+    (val) => val === `${prefix} #${tokenId}`,
+    `Short name must be exactly "${prefix} #${tokenId}"`
+  ).meta(meta);
+  return { schema, createSchema };
+}
+var massIDName = buildNameSchemas({
+  prefix: "MassID",
+  regexSuffix: " \u2022 .+ \u2022 .+t",
+  formatHint: "[waste_type] \u2022 [weight]t",
   title: "MassID Name",
   description: 'Full display name for this MassID NFT. Format: "MassID #[token_id] \u2022 [waste_type] \u2022 [weight]t"',
-  examples: [
-    "MassID #1034 \u2022 Organic \u2022 3.25t",
-    "MassID #123 \u2022 Plastic \u2022 2.5t"
-  ]
+  examples: ["MassID #1034 \u2022 Organic \u2022 3.25t", "MassID #123 \u2022 Plastic \u2022 2.5t"]
 });
-var MassIDShortNameSchema = NonEmptyStringSchema.max(50).regex(/^MassID #\d+$/, 'Short name must match format: "MassID #[token_id]"').meta({
+var massIDShortName = buildShortNameSchemas({
+  prefix: "MassID",
   title: "MassID Short Name",
   description: 'Compact name for UI summaries, tables, or tooltips. Format: "MassID #[token_id]"',
   examples: ["MassID #1034", "MassID #123"]
 });
-var GasIDNameSchema = NonEmptyStringSchema.max(100).regex(
-  /^GasID #\d+ • .+ • .+t CO₂e$/,
-  'Name must match format: "GasID #[token_id] \u2022 [methodology] \u2022 [co2e]t CO\u2082e"'
-).meta({
+var gasIDName = buildNameSchemas({
+  prefix: "GasID",
+  regexSuffix: " \u2022 .+ \u2022 .+t CO\u2082e",
+  formatHint: "[methodology] \u2022 [co2e]t CO\u2082e",
   title: "GasID Name",
   description: 'Full display name for this GasID NFT. Format: "GasID #[token_id] \u2022 [methodology] \u2022 [co2e]t CO\u2082e"',
   examples: [
@@ -28657,15 +28691,16 @@ var GasIDNameSchema = NonEmptyStringSchema.max(100).regex(
     "GasID #789 \u2022 BOLD Carbon (CH\u2084) \u2022 1.2t CO\u2082e"
   ]
 });
-var GasIDShortNameSchema = NonEmptyStringSchema.max(50).regex(/^GasID #\d+$/, 'Short name must match format: "GasID #[token_id]"').meta({
+var gasIDShortName = buildShortNameSchemas({
+  prefix: "GasID",
   title: "GasID Short Name",
   description: 'Compact name for UI summaries, tables, or tooltips. Format: "GasID #[token_id]"',
   examples: ["GasID #456", "GasID #789"]
 });
-var RecycledIDNameSchema = NonEmptyStringSchema.max(100).regex(
-  /^RecycledID #\d+ • .+ • .+t Recycled$/,
-  'Name must match format: "RecycledID #[token_id] \u2022 [methodology] \u2022 [weight]t Recycled"'
-).meta({
+var recycledIDName = buildNameSchemas({
+  prefix: "RecycledID",
+  regexSuffix: " \u2022 .+ \u2022 .+t Recycled",
+  formatHint: "[methodology] \u2022 [weight]t Recycled",
   title: "RecycledID Name",
   description: 'Full display name for this RecycledID NFT. Format: "RecycledID #[token_id] \u2022 [methodology] \u2022 [weight]t Recycled"',
   examples: [
@@ -28673,18 +28708,16 @@ var RecycledIDNameSchema = NonEmptyStringSchema.max(100).regex(
     "RecycledID #456 \u2022 BOLD Recycling \u2022 2.5t Recycled"
   ]
 });
-var RecycledIDShortNameSchema = NonEmptyStringSchema.max(50).regex(
-  /^RecycledID #\d+$/,
-  'Short name must match format: "RecycledID #[token_id]"'
-).meta({
+var recycledIDShortName = buildShortNameSchemas({
+  prefix: "RecycledID",
   title: "RecycledID Short Name",
   description: 'Compact name for UI summaries, tables, or tooltips. Format: "RecycledID #[token_id]"',
   examples: ["RecycledID #789", "RecycledID #456"]
 });
-var CreditPurchaseReceiptNameSchema = NonEmptyStringSchema.max(100).regex(
-  /^Credit Purchase Receipt #\d+ • .+ Credits Purchased$/,
-  'Name must match format: "Credit Purchase Receipt #[token_id] \u2022 [amount] Credits Purchased"'
-).meta({
+var creditPurchaseReceiptName = buildNameSchemas({
+  prefix: "Credit Purchase Receipt",
+  regexSuffix: " \u2022 .+ Credits Purchased",
+  formatHint: "[amount] Credits Purchased",
   title: "Credit Purchase Receipt Name",
   description: 'Full display name for this Credit Purchase Receipt NFT. Format: "Credit Purchase Receipt #[token_id] \u2022 [amount] Credits Purchased"',
   examples: [
@@ -28692,18 +28725,16 @@ var CreditPurchaseReceiptNameSchema = NonEmptyStringSchema.max(100).regex(
     "Credit Purchase Receipt #1200 \u2022 15.0 Credits Purchased"
   ]
 });
-var CreditPurchaseReceiptShortNameSchema = NonEmptyStringSchema.max(50).regex(
-  /^Purchase Receipt #\d+$/,
-  'Short name must match format: "Purchase Receipt #[token_id]"'
-).meta({
+var creditPurchaseReceiptShortName = buildShortNameSchemas({
+  prefix: "Purchase Receipt",
   title: "Credit Purchase Receipt Short Name",
   description: 'Compact name for UI summaries, tables, or tooltips. Format: "Purchase Receipt #[token_id]"',
   examples: ["Purchase Receipt #987", "Purchase Receipt #1200"]
 });
-var CreditRetirementReceiptNameSchema = NonEmptyStringSchema.max(100).regex(
-  /^Credit Retirement Receipt #\d+ • .+ Credits Retired$/,
-  'Name must match format: "Credit Retirement Receipt #[token_id] \u2022 [amount] Credits Retired"'
-).meta({
+var creditRetirementReceiptName = buildNameSchemas({
+  prefix: "Credit Retirement Receipt",
+  regexSuffix: " \u2022 .+ Credits Retired",
+  formatHint: "[amount] Credits Retired",
   title: "Credit Retirement Receipt Name",
   description: 'Full display name for this Credit Retirement Receipt NFT. Format: "Credit Retirement Receipt #[token_id] \u2022 [amount] Credits Retired"',
   examples: [
@@ -28711,145 +28742,36 @@ var CreditRetirementReceiptNameSchema = NonEmptyStringSchema.max(100).regex(
     "Credit Retirement Receipt #1200 \u2022 3.0 Credits Retired"
   ]
 });
-var CreditRetirementReceiptShortNameSchema = NonEmptyStringSchema.max(
-  50
-).regex(
-  /^Retirement Receipt #\d+$/,
-  'Short name must match format: "Retirement Receipt #[token_id]"'
-).meta({
-  title: "Credit Retirement Receipt Short Name",
-  description: 'Compact name for UI summaries, tables, or tooltips. Format: "Retirement Receipt #[token_id]"',
-  examples: ["Retirement Receipt #1245", "Retirement Receipt #1200"]
-});
-var createMassIDNameSchema = (tokenId) => {
-  const escapedTokenId = tokenId.replace("#", String.raw`\#`);
-  return NonEmptyStringSchema.max(100).regex(
-    new RegExp(String.raw`^MassID #${escapedTokenId} • .+ • .+t$`),
-    `Name must match format: "MassID #${tokenId} \u2022 [waste_type] \u2022 [weight]t"`
-  ).meta({
-    title: "MassID Name",
-    description: 'Full display name for this MassID NFT. Format: "MassID #[token_id] \u2022 [waste_type] \u2022 [weight]t"',
-    examples: [
-      "MassID #1034 \u2022 Organic \u2022 3.25t",
-      "MassID #123 \u2022 Plastic \u2022 2.5t"
-    ]
-  });
-};
-var createGasIDNameSchema = (tokenId) => {
-  const escapedTokenId = tokenId.replace("#", String.raw`\#`);
-  return NonEmptyStringSchema.max(100).regex(
-    new RegExp(String.raw`^GasID #${escapedTokenId} • .+ • .+t CO₂e$`),
-    `Name must match format: "GasID #${tokenId} \u2022 [methodology] \u2022 [co2e]t CO\u2082e"`
-  ).meta({
-    title: "GasID Name",
-    description: 'Full display name for this GasID NFT. Format: "GasID #[token_id] \u2022 [methodology] \u2022 [co2e]t CO\u2082e"',
-    examples: [
-      "GasID #456 \u2022 BOLD Carbon (CH\u2084) \u2022 0.86t CO\u2082e",
-      "GasID #789 \u2022 BOLD Carbon (CH\u2084) \u2022 1.2t CO\u2082e"
-    ]
-  });
-};
-var createRecycledIDNameSchema = (tokenId) => {
-  const escapedTokenId = tokenId.replace("#", String.raw`\#`);
-  return NonEmptyStringSchema.max(100).regex(
-    new RegExp(
-      String.raw`^RecycledID #${escapedTokenId} • .+ • .+t Recycled$`
-    ),
-    `Name must match format: "RecycledID #${tokenId} \u2022 [methodology] \u2022 [weight]t Recycled"`
-  ).meta({
-    title: "RecycledID Name",
-    description: 'Full display name for this RecycledID NFT. Format: "RecycledID #[token_id] \u2022 [methodology] \u2022 [weight]t Recycled"',
-    examples: [
-      "RecycledID #789 \u2022 BOLD Recycling \u2022 3.25t Recycled",
-      "RecycledID #456 \u2022 BOLD Recycling \u2022 2.5t Recycled"
-    ]
-  });
-};
-var createCreditPurchaseReceiptNameSchema = (tokenId) => {
-  const escapedTokenId = tokenId.replace("#", String.raw`\#`);
-  return NonEmptyStringSchema.max(100).regex(
-    new RegExp(
-      String.raw`^Credit Purchase Receipt #${escapedTokenId} • .+ Credits Purchased$`
-    ),
-    `Name must match format: "Credit Purchase Receipt #${tokenId} \u2022 [amount] Credits Purchased"`
-  ).meta({
-    title: "Credit Purchase Receipt Name",
-    description: 'Full display name for this Credit Purchase Receipt NFT. Format: "Credit Purchase Receipt #[token_id] \u2022 [amount] Credits Purchased"',
-    examples: [
-      "Credit Purchase Receipt #987 \u2022 8.5 Credits Purchased",
-      "Credit Purchase Receipt #1200 \u2022 15.0 Credits Purchased"
-    ]
-  });
-};
-var createCreditRetirementReceiptNameSchema = (tokenId) => {
-  const escapedTokenId = tokenId.replace("#", String.raw`\#`);
-  return NonEmptyStringSchema.max(100).regex(
-    new RegExp(
-      String.raw`^Credit Retirement Receipt #${escapedTokenId} • .+ Credits Retired$`
-    ),
-    `Name must match format: "Credit Retirement Receipt #${tokenId} \u2022 [amount] Credits Retired"`
-  ).meta({
-    title: "Credit Retirement Receipt Name",
-    description: 'Full display name for this Credit Retirement Receipt NFT. Format: "Credit Retirement Receipt #[token_id] \u2022 [amount] Credits Retired"',
-    examples: [
-      "Credit Retirement Receipt #1245 \u2022 10.5 Credits Retired",
-      "Credit Retirement Receipt #1200 \u2022 3.0 Credits Retired"
-    ]
-  });
-};
-var createMassIDShortNameSchema = (tokenId) => NonEmptyStringSchema.max(50).refine(
-  (val) => val === `MassID #${tokenId}`,
-  `Short name must be exactly "MassID #${tokenId}"`
-).meta({
-  title: "MassID Short Name",
-  description: 'Compact name for UI summaries, tables, or tooltips. Format: "MassID #[token_id]"',
-  examples: ["MassID #1034", "MassID #123"]
-});
-var createGasIDShortNameSchema = (tokenId) => NonEmptyStringSchema.max(50).refine(
-  (val) => val === `GasID #${tokenId}`,
-  `Short name must be exactly "GasID #${tokenId}"`
-).meta({
-  title: "GasID Short Name",
-  description: 'Compact name for UI summaries, tables, or tooltips. Format: "GasID #[token_id]"',
-  examples: ["GasID #456", "GasID #789"]
-});
-var createRecycledIDShortNameSchema = (tokenId) => NonEmptyStringSchema.max(50).refine(
-  (val) => val === `RecycledID #${tokenId}`,
-  `Short name must be exactly "RecycledID #${tokenId}"`
-).meta({
-  title: "RecycledID Short Name",
-  description: 'Compact name for UI summaries, tables, or tooltips. Format: "RecycledID #[token_id]"',
-  examples: ["RecycledID #789", "RecycledID #456"]
-});
-var createCreditPurchaseReceiptShortNameSchema = (tokenId) => NonEmptyStringSchema.max(50).refine(
-  (val) => val === `Purchase Receipt #${tokenId}`,
-  `Short name must be exactly "Purchase Receipt #${tokenId}"`
-).meta({
-  title: "Credit Purchase Receipt Short Name",
-  description: 'Compact name for UI summaries, tables, or tooltips. Format: "Purchase Receipt #[token_id]"',
-  examples: ["Purchase Receipt #987", "Purchase Receipt #1200"]
-});
-var createCreditRetirementReceiptShortNameSchema = (tokenId) => NonEmptyStringSchema.max(50).refine(
-  (val) => val === `Retirement Receipt #${tokenId}`,
-  `Short name must be exactly "Retirement Receipt #${tokenId}"`
-).meta({
+var creditRetirementReceiptShortName = buildShortNameSchemas({
+  prefix: "Retirement Receipt",
   title: "Credit Retirement Receipt Short Name",
   description: 'Compact name for UI summaries, tables, or tooltips. Format: "Retirement Receipt #[token_id]"',
   examples: ["Retirement Receipt #1245", "Retirement Receipt #1200"]
 });
+var MassIDNameSchema = massIDName.schema;
+var MassIDShortNameSchema = massIDShortName.schema;
+var createMassIDNameSchema = massIDName.createSchema;
+var createMassIDShortNameSchema = massIDShortName.createSchema;
+var GasIDNameSchema = gasIDName.schema;
+var GasIDShortNameSchema = gasIDShortName.schema;
+var createGasIDNameSchema = gasIDName.createSchema;
+var createGasIDShortNameSchema = gasIDShortName.createSchema;
+var RecycledIDNameSchema = recycledIDName.schema;
+var RecycledIDShortNameSchema = recycledIDShortName.schema;
+var createRecycledIDNameSchema = recycledIDName.createSchema;
+var createRecycledIDShortNameSchema = recycledIDShortName.createSchema;
+var CreditPurchaseReceiptNameSchema = creditPurchaseReceiptName.schema;
+var CreditPurchaseReceiptShortNameSchema = creditPurchaseReceiptShortName.schema;
+var createCreditPurchaseReceiptNameSchema = creditPurchaseReceiptName.createSchema;
+var createCreditPurchaseReceiptShortNameSchema = creditPurchaseReceiptShortName.createSchema;
+var CreditRetirementReceiptNameSchema = creditRetirementReceiptName.schema;
+var CreditRetirementReceiptShortNameSchema = creditRetirementReceiptShortName.schema;
+var createCreditRetirementReceiptNameSchema = creditRetirementReceiptName.createSchema;
+var createCreditRetirementReceiptShortNameSchema = creditRetirementReceiptShortName.createSchema;
 function getSchemaMetadata(schema) {
-  if (typeof schema.meta === "function") {
-    const meta = schema.meta();
-    if (meta && typeof meta === "object") {
-      return meta;
-    }
-  }
-  try {
-    const meta = z.globalRegistry.get(schema);
-    if (meta && typeof meta === "object") {
-      return meta;
-    }
-  } catch {
+  const meta = schema.meta();
+  if (meta && typeof meta === "object") {
+    return meta;
   }
   return void 0;
 }
@@ -28877,7 +28799,7 @@ function extractTraitType(schema) {
     if (meta?.title) {
       const title = meta.title;
       if (title.endsWith(" Attribute")) {
-        const inferred = title.slice(0, -11);
+        const inferred = title.slice(0, -" Attribute".length);
         if (inferred.length > 3) {
           return inferred;
         }
@@ -29389,7 +29311,7 @@ var AuditRuleExecutionResultsSchema = z.array(AuditRuleExecutionResultSchema).mi
 var ParticipantSchema = z.strictObject({
   id_hash: Sha256HashSchema.meta({
     title: "Participant ID Hash",
-    description: "Anonymized identifier for the participant"
+    description: "SHA-256 hash anonymizing the real participant identifier for privacy"
   }),
   roles: uniqueArrayItems(
     ParticipantRoleSchema,
@@ -29400,26 +29322,26 @@ var ParticipantSchema = z.strictObject({
   })
 }).meta({
   title: "Participant",
-  description: "A participant in the waste management supply chain"
+  description: "An entity (person, company, or cooperative) involved in the waste management supply chain"
 });
 var CoordinatesSchema = z.strictObject({
   latitude: LatitudeSchema,
   longitude: LongitudeSchema
 }).meta({
   title: "Coordinates",
-  description: "GPS coordinates of the location"
+  description: "Approximate GPS coordinates of the site (city-level precision for privacy)"
 });
 var LocationSchema = z.strictObject({
   id_hash: Sha256HashSchema.meta({
     title: "Location ID Hash",
-    description: "Anonymized identifier for the location"
+    description: "SHA-256 hash anonymizing the real location identifier for privacy"
   }),
   city: CitySchema,
   subdivision_code: IsoCountrySubdivisionCodeSchema,
   country_code: IsoCountryCodeSchema,
   responsible_participant_id_hash: Sha256HashSchema.meta({
     title: "Responsible Participant ID Hash",
-    description: "Anonymized ID of the participant responsible for this location"
+    description: "SHA-256 hash identifying the participant responsible for operations at this location"
   }),
   coordinates: CoordinatesSchema
 }).superRefine((record, ctx) => {
@@ -29448,17 +29370,17 @@ var WastePropertiesSchema = z.strictObject({
 var SummaryBaseSchema = z.strictObject({
   total_certificates: PositiveIntegerSchema.meta({
     title: "Total Certificates",
-    description: "Total number of certificates represented in the receipt"
+    description: "Total number of certificates (GasID or RecycledID) included in this receipt"
   })
 });
-var CreditPurchaseReceiptSummarySchema = SummaryBaseSchema.extend({
+var CreditPurchaseReceiptSummarySchema = SummaryBaseSchema.safeExtend({
   total_amount_usdc: UsdcAmountSchema.meta({
     title: "Total Amount (USDC)",
-    description: "Total amount paid in USDC for the purchase"
+    description: "Total amount paid in USDC stablecoin for the credit purchase"
   }),
   total_credits: CreditAmountSchema.meta({
     title: "Total Credits",
-    description: "Total amount of credits purchased"
+    description: "Total number of environmental impact credits purchased in this transaction"
   }),
   purchased_at: IsoDateTimeSchema.meta({
     title: "Purchased At",
@@ -29466,12 +29388,12 @@ var CreditPurchaseReceiptSummarySchema = SummaryBaseSchema.extend({
   })
 }).meta({
   title: "Credit Purchase Receipt Summary",
-  description: "Summary totals for the credit purchase including amounts and collections represented"
+  description: "Summary totals for the credit purchase including payment amount, credit quantity, certificate count, and timestamp"
 });
-var CreditRetirementReceiptSummarySchema = SummaryBaseSchema.extend({
+var CreditRetirementReceiptSummarySchema = SummaryBaseSchema.safeExtend({
   total_credits_retired: CreditAmountSchema.meta({
     title: "Total Credits Retired",
-    description: "Total amount of credits retired"
+    description: "Total number of environmental impact credits permanently retired (removed from circulation)"
   }),
   retired_at: IsoDateTimeSchema.meta({
     title: "Retired At",
@@ -29479,25 +29401,25 @@ var CreditRetirementReceiptSummarySchema = SummaryBaseSchema.extend({
   })
 }).meta({
   title: "Credit Retirement Receipt Summary",
-  description: "Summary totals for the credit retirement including amounts and collections represented"
+  description: "Summary totals for the credit retirement including credit quantity, certificate count, and timestamp"
 });
 var ReceiptIdentitySchema = z.strictObject({
   name: NonEmptyStringSchema.max(100).meta({
     title: "Identity Name",
-    description: "Display name for the participant",
+    description: "Display name of the buyer or beneficiary on the receipt",
     examples: ["EcoTech Solutions Inc.", "Climate Action Corp"]
   }),
   external_id: ExternalIdSchema.meta({
     title: "Identity External ID",
-    description: "External identifier for the participant"
+    description: "Unique identifier for the buyer or beneficiary in the Carrot platform"
   }),
   external_url: ExternalUrlSchema.meta({
     title: "Identity External URL",
-    description: "External URL for the participant profile"
+    description: "Link to the buyer or beneficiary profile page on the Carrot platform"
   })
 }).meta({
   title: "Identity",
-  description: "Participant identity information"
+  description: "Identity information for the buyer or beneficiary associated with this receipt"
 });
 function createReceiptCollectionSchema(params) {
   const { meta } = params;
@@ -29505,27 +29427,27 @@ function createReceiptCollectionSchema(params) {
     slug: CollectionSlugSchema,
     external_id: ExternalIdSchema.meta({
       title: "Collection External ID",
-      description: "External identifier for the collection"
+      description: "Unique identifier for the collection in the Carrot platform"
     }),
     name: CollectionNameSchema,
     external_url: ExternalUrlSchema.meta({
       title: "Collection External URL",
-      description: "External URL for the collection"
+      description: "Link to the collection page on the Carrot platform"
     }),
     ipfs_uri: IpfsUriSchema.meta({
       title: "Collection IPFS URI",
-      description: "IPFS URI for the collection metadata"
+      description: "IPFS URI pointing to the immutable collection metadata record"
     })
   }).meta(meta);
 }
 var CertificateCollectionItemPurchaseSchema = z.strictObject({
   slug: CollectionSlugSchema.meta({
     title: "Collection Slug",
-    description: "Slug of the collection"
+    description: "URL-friendly identifier of the collection this certificate belongs to"
   }),
   purchased_amount: CreditAmountSchema.meta({
-    title: "Collection Purchased Amount",
-    description: "Credits purchased from this collection for this certificate"
+    title: "Purchased Amount",
+    description: "Number of credits purchased from this collection for this certificate"
   }),
   retired_amount: CreditAmountSchema.meta({
     title: "Collection Retired Amount",
@@ -29553,7 +29475,7 @@ function buildSchemaUrl(schemaPath) {
   return `${getSchemaBaseUrl()}/${cleanPath}`;
 }
 function getSchemaVersionOrDefault() {
-  return "0.2.3";
+  return "0.3.0";
 }
 
 // src/shared/schema-validation.ts
@@ -30156,7 +30078,7 @@ var MassIDAttachmentSchema = z.strictObject({
   })
 }).meta({
   title: "MassID Attachment",
-  description: "Attachment associated with a specific MassID event, linked by event_id"
+  description: "Regulatory document (Transport Manifest or Recycling Manifest) linked to a specific lifecycle event via event_id"
 });
 var MassIDBaseEventSchema = z.strictObject({
   event_id: UuidSchema.meta({
@@ -30174,7 +30096,7 @@ var MassIDBaseEventSchema = z.strictObject({
   })
 }).meta({
   title: "MassID Base Event",
-  description: "Base MassID event definition shared across event types"
+  description: "Common fields for all MassID lifecycle events: identifier, timestamp, participant reference, and location reference"
 });
 var buildMassIDEventSchema = (eventName, description) => MassIDBaseEventSchema.safeExtend({
   event_name: z.literal(eventName).meta({
@@ -30200,7 +30122,7 @@ var PickUpEventSchema = buildMassIDEventSchema(
     })
   }).optional().meta({
     title: "Pick-up Event Data",
-    description: "Data associated with the pick-up event"
+    description: "Optional vehicle and weight details captured during waste pick-up"
   })
 });
 var WeighingEventSchema = buildMassIDEventSchema(
@@ -30347,7 +30269,7 @@ var MassIDDataSchema = z.strictObject({
   );
 }, "All responsible participant ID hashes in locations must exist in participants array").meta({
   title: "MassID Data",
-  description: "MassID data containing waste tracking events and supporting information"
+  description: "Complete MassID data including waste properties, geographic locations, supply-chain participants, chronological lifecycle events, and regulatory attachments"
 });
 var isPickUpEvent = (event) => event.event_name === "Pick-up";
 var isWeighingEvent = (event) => event.event_name === "Weighing";
@@ -30355,7 +30277,7 @@ var isDropOffEvent = (event) => event.event_name === "Drop-off";
 var isRecyclingEvent = (event) => event.event_name === "Recycling";
 var MassIDIpfsSchemaMeta = {
   title: "MassID NFT IPFS Record",
-  description: "Complete MassID NFT IPFS record schema defining waste tracking metadata, chain of custody events, and NFT display attributes",
+  description: "Complete MassID NFT IPFS record including waste classification, chain-of-custody lifecycle events, geographic locations, supply-chain participants, and NFT display attributes",
   $id: buildSchemaUrl("mass-id/mass-id.schema.json"),
   version: getSchemaVersionOrDefault()
 };
@@ -30363,7 +30285,7 @@ var MassIDIpfsSchema = NftIpfsSchema.safeExtend({
   schema: NftIpfsSchema.shape.schema.safeExtend({
     type: z.literal("MassID").meta({
       title: "MassID Schema Type",
-      description: "Schema type identifier for this record"
+      description: "Discriminator value identifying this record as a MassID waste-traceability certificate"
     })
   }),
   name: MassIDNameSchema,
@@ -30386,6 +30308,22 @@ var MassIDIpfsSchema = NftIpfsSchema.safeExtend({
     path: ["short_name"],
     message: `Short name token_id must match blockchain.token_id: ${record.blockchain.token_id}`
   });
+  const nameSchema = createMassIDNameSchema(record.blockchain.token_id);
+  validateFormattedName({
+    ctx,
+    name: record.name,
+    schema: nameSchema,
+    path: ["name"]
+  });
+  const shortNameSchema = createMassIDShortNameSchema(
+    record.blockchain.token_id
+  );
+  validateFormattedName({
+    ctx,
+    name: record.short_name,
+    schema: shortNameSchema,
+    path: ["short_name"]
+  });
   const { data, attributes } = record;
   const attributeByTraitType = createAttributeMap(attributes);
   validateAttributeValue({
@@ -30515,7 +30453,7 @@ var GasIDAttributeGasTypeSchema = NftAttributeSchema.safeExtend({
   value: GasTypeSchema
 }).meta({
   title: "Gas Type Attribute",
-  description: "Gas type attribute"
+  description: "Type of greenhouse gas whose emissions were prevented (e.g., Methane (CH\u2084))"
 });
 var GasIDAttributeCo2ePreventedSchema = createNumericAttributeSchema({
   traitType: "CO\u2082e Prevented (kg)",
@@ -30569,7 +30507,7 @@ var GasIDSummarySchema = z.strictObject({
   })
 }).meta({
   title: "GasID Summary",
-  description: "Summary information for the GasID certificate"
+  description: "Key metrics for the GasID certificate including gas type, credit details, prevented emissions, and issuance timestamps"
 });
 var CalculationValueSchema = z.strictObject({
   reference: NonEmptyStringSchema.max(3).meta({
@@ -30593,7 +30531,7 @@ var CalculationValueSchema = z.strictObject({
   })
 }).meta({
   title: "Calculation Value",
-  description: "Single value used in the emissions calculation"
+  description: "Named parameter or computed result used in the prevented emissions formula"
 });
 var PreventedEmissionsCalculationSchema = z.strictObject({
   formula: NonEmptyStringSchema.max(100).meta({
@@ -30612,11 +30550,11 @@ var PreventedEmissionsCalculationSchema = z.strictObject({
   }),
   values: z.array(CalculationValueSchema).min(1).meta({
     title: "Calculation Values",
-    description: "Values used to calculate the prevented emissions"
+    description: "Input parameters and computed result used in the prevented emissions formula"
   })
 }).meta({
   title: "Prevented Emissions Calculation",
-  description: "Details of the prevented emissions calculation"
+  description: "Methodology-based calculation of prevented CO\u2082e emissions, including formula, method, input values, and computation timestamp"
 });
 var GasIDDataSchema = z.strictObject({
   summary: GasIDSummarySchema,
@@ -30626,16 +30564,16 @@ var GasIDDataSchema = z.strictObject({
   waste_properties: WastePropertiesSchema,
   origin_location: LocationSchema.meta({
     title: "Source Waste Origin Location",
-    description: "Location of the waste origin"
+    description: "Geographic location where the source waste was originally collected"
   }),
   prevented_emissions_calculation: PreventedEmissionsCalculationSchema
 }).meta({
   title: "GasID Data",
-  description: "Complete data structure for GasID certificate"
+  description: "Complete GasID certificate data including summary metrics, methodology reference, audit trail, source MassID, waste properties, origin location, and emissions calculation"
 });
 var GasIDIpfsSchemaMeta = {
   title: "GasID NFT IPFS Record",
-  description: "Complete GasID NFT IPFS record including fixed attributes and detailed carbon emissions prevention data",
+  description: "Complete GasID NFT IPFS record including prevented emissions calculation, source waste provenance, methodology reference, and NFT display attributes",
   $id: buildSchemaUrl("gas-id/gas-id.schema.json"),
   version: getSchemaVersionOrDefault()
 };
@@ -30643,7 +30581,7 @@ var GasIDIpfsSchema = NftIpfsSchema.safeExtend({
   schema: NftIpfsSchema.shape.schema.safeExtend({
     type: z.literal("GasID").meta({
       title: "GasID Schema Type",
-      description: "GasID NFT schema type"
+      description: "Discriminator value identifying this record as a GasID prevented-emissions certificate"
     })
   }),
   name: GasIDNameSchema,
@@ -30853,7 +30791,7 @@ var RecycledIDSummarySchema = z.strictObject({
   })
 }).meta({
   title: "RecycledID Summary",
-  description: "Summary information for the RecycledID certificate"
+  description: "Key metrics for the RecycledID certificate including recycled weight, credit details, and issuance timestamps"
 });
 var RecycledIDDataSchema = z.strictObject({
   summary: RecycledIDSummarySchema,
@@ -30863,15 +30801,15 @@ var RecycledIDDataSchema = z.strictObject({
   waste_properties: WastePropertiesSchema,
   origin_location: LocationSchema.meta({
     title: "RecycledID Origin Location",
-    description: "Source waste origin location details"
+    description: "Geographic location where the source waste was originally collected"
   })
 }).meta({
   title: "RecycledID Data",
-  description: "Complete data structure for RecycledID certificate"
+  description: "Complete RecycledID certificate data including summary metrics, methodology reference, audit trail, source MassID, waste properties, and origin location"
 });
 var RecycledIDIpfsSchemaMeta = {
   title: "RecycledID NFT IPFS Record",
-  description: "Complete RecycledID NFT IPFS record including fixed attributes and recycling outcome data",
+  description: "Complete RecycledID NFT IPFS record including recycling outcome metrics, source waste provenance, methodology reference, and NFT display attributes",
   $id: buildSchemaUrl("recycled-id/recycled-id.schema.json"),
   version: getSchemaVersionOrDefault()
 };
@@ -30879,7 +30817,7 @@ var RecycledIDIpfsSchema = NftIpfsSchema.safeExtend({
   schema: NftIpfsSchema.shape.schema.safeExtend({
     type: z.literal("RecycledID").meta({
       title: "RecycledID Schema Type",
-      description: "RecycledID NFT schema type"
+      description: "Discriminator value identifying this record as a RecycledID recycling-outcome certificate"
     })
   }),
   name: RecycledIDNameSchema,
@@ -31157,7 +31095,7 @@ var CreditPurchaseReceiptDataSchema = z.strictObject({
     "Collection slugs must be unique"
   ).min(1).meta({
     title: "Collections",
-    description: "Collections included in the purchase"
+    description: "Impact collections referenced by this purchase, each identified by a unique slug"
   }),
   credits: uniqueBy(
     CreditPurchaseReceiptCreditSchema,
@@ -31165,7 +31103,7 @@ var CreditPurchaseReceiptDataSchema = z.strictObject({
     "Credit slugs must be unique"
   ).min(1).meta({
     title: "Credits",
-    description: "Credits included in the purchase"
+    description: "Credit token types involved in this purchase, each identified by a unique slug and symbol"
   }),
   certificates: uniqueBy(
     CreditPurchaseReceiptCertificateSchema,
@@ -31173,7 +31111,7 @@ var CreditPurchaseReceiptDataSchema = z.strictObject({
     "Certificate token_ids must be unique"
   ).min(1).meta({
     title: "Certificates",
-    description: "Certificates involved in the purchase"
+    description: "Environmental certificates allocated in this purchase, each linking a credit type to collection-level purchased and retired amounts"
   }),
   retirement_receipt: CreditPurchaseReceiptRetirementReceiptSchema.optional()
 }).superRefine((data, ctx) => {
@@ -31273,7 +31211,7 @@ var CreditPurchaseReceiptDataSchema = z.strictObject({
 });
 var CreditPurchaseReceiptIpfsSchemaMeta = {
   title: "CreditPurchaseReceipt NFT IPFS Record",
-  description: "Complete CreditPurchaseReceipt NFT IPFS record including attributes and credit purchase data",
+  description: "Complete CreditPurchaseReceipt NFT IPFS record including purchase summary, buyer details, credit breakdowns, certificate allocations, and NFT display attributes",
   $id: buildSchemaUrl(
     "credit-purchase-receipt/credit-purchase-receipt.schema.json"
   ),
@@ -31283,7 +31221,7 @@ var CreditPurchaseReceiptIpfsSchema = NftIpfsSchema.safeExtend({
   schema: NftIpfsSchema.shape.schema.safeExtend({
     type: z.literal("CreditPurchaseReceipt").meta({
       title: "CreditPurchaseReceipt Schema Type",
-      description: "Schema type identifier for this record"
+      description: "Discriminator value identifying this record as a CreditPurchaseReceipt transaction proof"
     })
   }),
   name: CreditPurchaseReceiptNameSchema,
@@ -31619,7 +31557,7 @@ var CreditRetirementReceiptDataSchema = z.strictObject({
     "Collection slugs must be unique"
   ).min(1).meta({
     title: "Collections",
-    description: "Collections included in the retirement"
+    description: "Impact collections referenced by this retirement, each identified by a unique slug"
   }),
   credits: uniqueBy(
     CreditRetirementReceiptCreditSchema,
@@ -31627,7 +31565,7 @@ var CreditRetirementReceiptDataSchema = z.strictObject({
     "Credit slugs must be unique"
   ).min(1).meta({
     title: "Credits",
-    description: "Credits included in the retirement"
+    description: "Credit token types retired in this receipt, each identified by a unique slug and symbol"
   }),
   certificates: uniqueBy(
     CreditRetirementReceiptCertificateSchema,
@@ -31635,7 +31573,7 @@ var CreditRetirementReceiptDataSchema = z.strictObject({
     "Certificate token_ids must be unique"
   ).min(1).meta({
     title: "Certificates",
-    description: "Certificates retired in this receipt"
+    description: "Environmental certificates retired in this receipt, each linking collection-level retired amounts to per-credit breakdowns"
   }),
   purchase_receipt: CreditPurchaseReceiptReferenceSchema.optional()
 }).superRefine((data, ctx) => {
@@ -31760,7 +31698,7 @@ var CreditRetirementReceiptDataSchema = z.strictObject({
 });
 var CreditRetirementReceiptIpfsSchemaMeta = {
   title: "CreditRetirementReceipt NFT IPFS Record",
-  description: "Complete CreditRetirementReceipt NFT IPFS record including attributes and credit retirement data",
+  description: "Complete CreditRetirementReceipt NFT IPFS record including retirement summary, beneficiary and credit holder details, credit breakdowns, certificate allocations, and NFT display attributes",
   $id: buildSchemaUrl(
     "credit-retirement-receipt/credit-retirement-receipt.schema.json"
   ),
@@ -31770,7 +31708,7 @@ var CreditRetirementReceiptIpfsSchema = NftIpfsSchema.safeExtend({
   schema: NftIpfsSchema.shape.schema.safeExtend({
     type: z.literal("CreditRetirementReceipt").meta({
       title: "CreditRetirementReceipt Schema Type",
-      description: "Schema type identifier for this record"
+      description: "Discriminator value identifying this record as a CreditRetirementReceipt permanent-offset proof"
     })
   }),
   name: CreditRetirementReceiptNameSchema,
@@ -31923,7 +31861,7 @@ var CollectionSchema = BaseIpfsSchema.safeExtend({
   schema: BaseIpfsSchema.shape.schema.safeExtend({
     type: z.literal("Collection").meta({
       title: "Collection Schema Type",
-      description: "Schema type identifier for this record"
+      description: "Discriminator value identifying this record as a Collection grouping of credits and receipts"
     })
   }),
   data: z.record(z.string(), z.unknown()).optional().meta({
@@ -31957,7 +31895,7 @@ var CreditSchema = BaseIpfsSchema.safeExtend({
   schema: BaseIpfsSchema.shape.schema.safeExtend({
     type: z.literal("Credit").meta({
       title: "Credit Schema Type",
-      description: "Schema type identifier for this record"
+      description: "Discriminator value identifying this record as a Credit environmental-impact token"
     })
   }),
   data: z.record(z.string(), z.unknown()).optional().meta({
@@ -31983,7 +31921,7 @@ var CreditSchema = BaseIpfsSchema.safeExtend({
     title: "Token Description",
     description: "Comprehensive description of the credit token, its purpose, and impact",
     examples: [
-      "Carrot Carbon (C-CARB.CH4) represents verified carbon emissions reductions from organic waste composting projects. Each token equals one metric ton of CO2 equivalent prevented from entering the atmosphere through sustainable waste management practices."
+      "Carrot Carbon (C-CARB.CH4) represents verified prevented emissions from organic waste composting projects. Each token equals one metric ton of CO\u2082 equivalent (CO\u2082e) prevented from entering the atmosphere through sustainable waste management practices."
     ]
   })
 }).meta(CreditSchemaMeta);
@@ -31993,7 +31931,7 @@ var MethodologyDataSchema = z.strictObject({
   slug: MethodologySlugSchema,
   version: SemanticVersionSchema.meta({
     title: "Methodology Version",
-    description: "Version of the methodology"
+    description: "Semantic version of this methodology revision (e.g., 1.0.0)"
   }),
   description: z.string().min(50).max(2e3).meta({
     title: "Methodology Description",
@@ -32023,7 +31961,7 @@ var MethodologyDataSchema = z.strictObject({
 // src/methodology/methodology.schema.ts
 var MethodologySchemaMeta = {
   title: "Methodology IPFS Record",
-  description: "Methodology metadata stored in IPFS, extending the base schema with methodology data and audit rules",
+  description: "Methodology metadata stored in IPFS, defining the environmental impact measurement approach including versioning, documentation, and MassID audit rules",
   $id: buildSchemaUrl("methodology/methodology.schema.json"),
   version: getSchemaVersionOrDefault()
 };
@@ -32031,7 +31969,7 @@ var MethodologySchema = BaseIpfsSchema.safeExtend({
   schema: BaseIpfsSchema.shape.schema.safeExtend({
     type: z.literal("Methodology").meta({
       title: "Methodology Schema Type",
-      description: "Schema type identifier for this record"
+      description: "Discriminator value identifying this record as a Methodology impact-measurement definition"
     })
   }),
   data: MethodologyDataSchema
@@ -32061,7 +31999,7 @@ var MassIDAuditSummarySchema = z.strictObject({
   }
 }).meta({
   title: "Audit Summary",
-  description: "Summary of audit execution results"
+  description: "Overview of the audit execution including start time, completion time, and overall pass/fail result"
 });
 var MassIDAuditDataSchema = z.strictObject({
   methodology: MethodologyReferenceSchema,
@@ -32071,9 +32009,9 @@ var MassIDAuditDataSchema = z.strictObject({
   audit_summary: MassIDAuditSummarySchema,
   rule_execution_results: AuditRuleExecutionResultsSchema
 }).superRefine((data, ctx) => {
-  const hasGasId = !!data.gas_id;
-  const hasRecycledId = !!data.recycled_id;
-  if (!hasGasId && !hasRecycledId) {
+  const hasGasID = !!data.gas_id;
+  const hasRecycledID = !!data.recycled_id;
+  if (!hasGasID && !hasRecycledID) {
     ctx.addIssue({
       code: "custom",
       path: ["gas_id"],
@@ -32085,7 +32023,7 @@ var MassIDAuditDataSchema = z.strictObject({
       message: "Either gas_id or recycled_id must be provided"
     });
   }
-  if (hasGasId && hasRecycledId) {
+  if (hasGasID && hasRecycledID) {
     ctx.addIssue({
       code: "custom",
       path: ["gas_id"],
@@ -32105,7 +32043,7 @@ var MassIDAuditDataSchema = z.strictObject({
 // src/mass-id-audit/mass-id-audit.schema.ts
 var MassIDAuditSchemaMeta = {
   title: "MassID Audit IPFS Record",
-  description: "MassID audit metadata stored in IPFS, extending the base schema with audit results and references",
+  description: "MassID audit record stored in IPFS, containing methodology reference, audit summary, rule execution results, and links to the source MassID and resulting GasID or RecycledID",
   $id: buildSchemaUrl("mass-id-audit/mass-id-audit.schema.json"),
   version: getSchemaVersionOrDefault()
 };
@@ -32113,12 +32051,11 @@ var MassIDAuditSchema = BaseIpfsSchema.safeExtend({
   schema: BaseIpfsSchema.shape.schema.safeExtend({
     type: z.literal("MassID Audit").meta({
       title: "MassID Audit Schema Type",
-      description: "MassID Audit schema type"
+      description: "Discriminator value identifying this record as a MassID Audit methodology-rule execution report"
     })
   }),
   data: MassIDAuditDataSchema
 }).meta(MassIDAuditSchemaMeta);
-/* v8 ignore file -- @preserve */
 
 export { ALLOWED_BLOCKCHAIN_NETWORKS, AuditReferenceSchema, AuditResultSchema, AuditRuleDefinitionSchema, AuditRuleDefinitionsSchema, AuditRuleExecutionResultSchema, AuditRuleExecutionResultsSchema, BLOCKCHAIN_NETWORK_CONFIG, BRAZIL_COUNTRY_CODE, BRAZIL_MUNICIPALITIES, BRAZIL_MUNICIPALITIES_NAMES, BRAZIL_SUBDIVISION_CODES, BaseIpfsSchema, BlockchainChainIdSchema, BlockchainNetworkNameSchema, CertificateCollectionItemPurchaseSchema, CertificateCollectionItemRetirementSchema, CertificateIssuanceDateAttributeSchema, CertificateReferenceBaseSchema, CertificateTypeSchema, CitySchema, CollectionNameSchema, CollectionSchema, CollectionSchemaMeta, CollectionSlugSchema, ContainerTypeSchema, CoordinatesSchema, CreditAmountAttributeSchema, CreditAmountSchema, CreditPurchaseReceiptAttributesSchema, CreditPurchaseReceiptDataSchema, CreditPurchaseReceiptIpfsSchema, CreditPurchaseReceiptIpfsSchemaMeta, CreditPurchaseReceiptNameSchema, CreditPurchaseReceiptReferenceSchema, CreditPurchaseReceiptShortNameSchema, CreditPurchaseReceiptSummarySchema, CreditReferenceSchema, CreditRetirementReceiptAttributesSchema, CreditRetirementReceiptDataSchema, CreditRetirementReceiptIpfsSchema, CreditRetirementReceiptIpfsSchemaMeta, CreditRetirementReceiptNameSchema, CreditRetirementReceiptReferenceSchema, CreditRetirementReceiptShortNameSchema, CreditRetirementReceiptSummarySchema, CreditSchema, CreditSchemaMeta, CreditTokenNameSchema, CreditTokenSlugSchema, CreditTokenSymbolSchema, CreditTypeAttributeSchema, CreditTypeSchema, EPSILON, EnsDomainSchema, EthereumAddressSchema, ExternalIdSchema, ExternalUrlSchema, GasIDAttributesSchema, GasIDDataSchema, GasIDIpfsSchema, GasIDIpfsSchemaMeta, GasIDNameSchema, GasIDReferenceSchema, GasIDShortNameSchema, GasTypeSchema, HexColorSchema, IbamaWasteClassificationSchema, IpfsCidSchema, IpfsUriSchema, IpnsSchema, IsoCountryCodeSchema, IsoCountrySubdivisionCodeSchema, IsoDateSchema, IsoDateTimeSchema, LatitudeSchema, LocationSchema, LongitudeSchema, MassIDAttributesSchema, MassIDAuditDataSchema, MassIDAuditSchema, MassIDAuditSchemaMeta, MassIDAuditSummarySchema, MassIDDataSchema, MassIDIpfsSchema, MassIDIpfsSchemaMeta, MassIDNameSchema, MassIDRecyclingDateAttributeSchema, MassIDReferenceSchema, MassIDShortNameSchema, MassIDTokenIdAttributeSchema, MethodologyAttributeSchema, MethodologyDataSchema, MethodologyNameSchema, MethodologyReferenceSchema, MethodologySchema, MethodologySchemaMeta, MethodologyShortNameSchema, MethodologySlugSchema, NftAttributeSchema, NftIpfsSchema, NftTokenReferenceBaseSchema, NonEmptyStringSchema, NonNegativeFloatSchema, NonNegativeIntegerSchema, OriginCityAttributeSchema, OriginCountrySubdivisionAttributeSchema, ParticipantIdHashSchema, ParticipantRoleSchema, ParticipantSchema, PercentageSchema, PositiveIntegerSchema, ReceiptIdentitySchema, RecordEnvironmentSchema, RecordSchemaTypeSchema, RecycledIDAttributesSchema, RecycledIDDataSchema, RecycledIDIpfsSchema, RecycledIDIpfsSchemaMeta, RecycledIDNameSchema, RecycledIDReferenceSchema, RecycledIDShortNameSchema, RecyclingDateAttributeSchema, ScaleTypeSchema, SchemaInfoSchema, SemanticVersionSchema, Sha256HashSchema, SlugSchema, SmartContractAddressSchema, SmartContractSchema, SourceWasteTypeAttributeSchema, SourceWeightAttributeSchema, StringifiedTokenIdSchema, TokenIdSchema, TokenReferenceBaseSchema, UnixTimestampSchema, UsdcAmountSchema, UuidSchema, VehicleTypeSchema, ViewerReferenceSchema, WastePropertiesSchema, WasteSubtypeSchema, WasteTypeSchema, WeighingCaptureMethodSchema, WeightKgSchema, buildSchemaUrl, canonicalizeForHash, createAttributeMap, createCreditPurchaseReceiptNameSchema, createCreditPurchaseReceiptShortNameSchema, createCreditRetirementReceiptNameSchema, createCreditRetirementReceiptShortNameSchema, createDateAttributeSchema, createGasIDNameSchema, createGasIDShortNameSchema, createMassIDNameSchema, createMassIDShortNameSchema, createNumericAttributeSchema, createOrderedAttributesSchema, createReceiptCollectionSchema, createRecycledIDNameSchema, createRecycledIDShortNameSchema, createWeightAttributeSchema, getSchemaBaseUrl, getSchemaVersionOrDefault, hashCanonicalJson, hashObject, nearlyEqual, uniqueArrayItems, uniqueBy, validateAttributeValue, validateAttributesForItems, validateCertificateCollectionSlugs, validateCollectionsHaveRetiredAmounts, validateCountMatches, validateCreditSlugExists, validateCreditSymbolExists, validateDateAttribute, validateDateTimeAttribute, validateFormattedName, validateLocationBrazilData, validateNumericAttributeValue, validateRetirementReceiptRequirement, validateSummaryListMatchesData, validateTokenIdInName, validateTotalMatches };
 //# sourceMappingURL=index.js.map