@carrot-foundation/schemas 0.2.4 → 0.3.0

package/dist/index.cjs

@@ -13,8 +13,8 @@ var canonicalize__default = /*#__PURE__*/_interopDefault(canonicalize);
 // src/mass-id/mass-id.attributes.ts
 var NonEmptyStringSchema = zod.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-]+$/,
@@ -64,7 +64,8 @@ var PositiveIntegerSchema = zod.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) => {
@@ -28041,16 +28042,16 @@ var IsoCountrySubdivisionCodeSchema = zod.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 = zod.z.number().min(-90).max(90).multipleOf(0.1).meta({
   title: "Latitude",
@@ -28117,7 +28118,7 @@ var UuidSchema = zod.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+$/,
@@ -28131,9 +28132,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 = zod.z.hash("sha256", {
   error: "Must be a SHA256 hash as 32-byte hex string"
@@ -28147,7 +28149,7 @@ var Sha256HashSchema = zod.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"
   ]
@@ -28222,8 +28224,8 @@ var RecordSchemaTypeSchema = zod.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 = zod.z.enum(["Carrot Carbon (CH\u2084)", "Carrot Biowaste"]).meta({
   title: "Credit Token Name",
@@ -28242,12 +28244,12 @@ var CreditTokenSymbolSchema = zod.z.enum(["C-CARB.CH4", "C-BIOW"]).meta({
 });
 var CreditTypeSchema = zod.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 = zod.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 = zod.z.enum([
@@ -28263,8 +28265,8 @@ var VehicleTypeSchema = zod.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 = zod.z.enum([
   "Bin Scale",
@@ -28279,18 +28281,18 @@ var ScaleTypeSchema = zod.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 = zod.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 = zod.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 = zod.z.enum([
   "bold-innovators",
@@ -28299,7 +28301,7 @@ var CollectionSlugSchema = zod.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 = zod.z.enum([
@@ -28319,7 +28321,7 @@ var ParticipantRoleSchema = zod.z.enum([
 });
 var WasteTypeSchema = zod.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 = zod.z.enum([
@@ -28332,8 +28334,8 @@ var WasteSubtypeSchema = zod.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 = zod.z.enum([
   "BOLD Innovators",
@@ -28342,7 +28344,7 @@ var CollectionNameSchema = zod.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 = zod.z.enum([
@@ -28368,7 +28370,7 @@ var MethodologySlugSchema = zod.z.enum(["bold-recycling", "bold-carbon-ch4"]).me
 });
 var CertificateTypeSchema = zod.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"]
 });
 
@@ -28670,7 +28672,7 @@ function buildShortNameSchemas(config) {
   ).meta(meta);
   return { schema, createSchema };
 }
-var massIdName = buildNameSchemas({
+var massIDName = buildNameSchemas({
   prefix: "MassID",
   regexSuffix: " \u2022 .+ \u2022 .+t",
   formatHint: "[waste_type] \u2022 [weight]t",
@@ -28678,13 +28680,13 @@ var massIdName = buildNameSchemas({
   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 massIdShortName = buildShortNameSchemas({
+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 gasIdName = buildNameSchemas({
+var gasIDName = buildNameSchemas({
   prefix: "GasID",
   regexSuffix: " \u2022 .+ \u2022 .+t CO\u2082e",
   formatHint: "[methodology] \u2022 [co2e]t CO\u2082e",
@@ -28695,13 +28697,13 @@ var gasIdName = buildNameSchemas({
     "GasID #789 \u2022 BOLD Carbon (CH\u2084) \u2022 1.2t CO\u2082e"
   ]
 });
-var gasIdShortName = buildShortNameSchemas({
+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 recycledIdName = buildNameSchemas({
+var recycledIDName = buildNameSchemas({
   prefix: "RecycledID",
   regexSuffix: " \u2022 .+ \u2022 .+t Recycled",
   formatHint: "[methodology] \u2022 [weight]t Recycled",
@@ -28712,7 +28714,7 @@ var recycledIdName = buildNameSchemas({
     "RecycledID #456 \u2022 BOLD Recycling \u2022 2.5t Recycled"
   ]
 });
-var recycledIdShortName = buildShortNameSchemas({
+var recycledIDShortName = buildShortNameSchemas({
   prefix: "RecycledID",
   title: "RecycledID Short Name",
   description: 'Compact name for UI summaries, tables, or tooltips. Format: "RecycledID #[token_id]"',
@@ -28752,18 +28754,18 @@ var creditRetirementReceiptShortName = buildShortNameSchemas({
   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 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;
@@ -29315,7 +29317,7 @@ var AuditRuleExecutionResultsSchema = zod.z.array(AuditRuleExecutionResultSchema
 var ParticipantSchema = zod.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,
@@ -29326,26 +29328,26 @@ var ParticipantSchema = zod.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 = zod.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 = zod.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) => {
@@ -29374,17 +29376,17 @@ var WastePropertiesSchema = zod.z.strictObject({
 var SummaryBaseSchema = zod.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.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",
@@ -29392,12 +29394,12 @@ var CreditPurchaseReceiptSummarySchema = SummaryBaseSchema.safeExtend({
   })
 }).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.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",
@@ -29405,25 +29407,25 @@ var CreditRetirementReceiptSummarySchema = SummaryBaseSchema.safeExtend({
   })
 }).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 = zod.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;
@@ -29431,27 +29433,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 = zod.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",
@@ -29479,7 +29481,7 @@ function buildSchemaUrl(schemaPath) {
   return `${getSchemaBaseUrl()}/${cleanPath}`;
 }
 function getSchemaVersionOrDefault() {
-  return "0.2.4";
+  return "0.3.0";
 }
 
 // src/shared/schema-validation.ts
@@ -30082,7 +30084,7 @@ var MassIDAttachmentSchema = zod.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 = zod.z.strictObject({
   event_id: UuidSchema.meta({
@@ -30100,7 +30102,7 @@ var MassIDBaseEventSchema = zod.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: zod.z.literal(eventName).meta({
@@ -30126,7 +30128,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(
@@ -30273,7 +30275,7 @@ var MassIDDataSchema = zod.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";
@@ -30281,7 +30283,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()
 };
@@ -30289,7 +30291,7 @@ var MassIDIpfsSchema = NftIpfsSchema.safeExtend({
   schema: NftIpfsSchema.shape.schema.safeExtend({
     type: zod.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,
@@ -30457,7 +30459,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)",
@@ -30511,7 +30513,7 @@ var GasIDSummarySchema = zod.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 = zod.z.strictObject({
   reference: NonEmptyStringSchema.max(3).meta({
@@ -30535,7 +30537,7 @@ var CalculationValueSchema = zod.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 = zod.z.strictObject({
   formula: NonEmptyStringSchema.max(100).meta({
@@ -30554,11 +30556,11 @@ var PreventedEmissionsCalculationSchema = zod.z.strictObject({
   }),
   values: zod.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 = zod.z.strictObject({
   summary: GasIDSummarySchema,
@@ -30568,16 +30570,16 @@ var GasIDDataSchema = zod.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()
 };
@@ -30585,7 +30587,7 @@ var GasIDIpfsSchema = NftIpfsSchema.safeExtend({
   schema: NftIpfsSchema.shape.schema.safeExtend({
     type: zod.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,
@@ -30795,7 +30797,7 @@ var RecycledIDSummarySchema = zod.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 = zod.z.strictObject({
   summary: RecycledIDSummarySchema,
@@ -30805,15 +30807,15 @@ var RecycledIDDataSchema = zod.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()
 };
@@ -30821,7 +30823,7 @@ var RecycledIDIpfsSchema = NftIpfsSchema.safeExtend({
   schema: NftIpfsSchema.shape.schema.safeExtend({
     type: zod.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,
@@ -31099,7 +31101,7 @@ var CreditPurchaseReceiptDataSchema = zod.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,
@@ -31107,7 +31109,7 @@ var CreditPurchaseReceiptDataSchema = zod.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,
@@ -31115,7 +31117,7 @@ var CreditPurchaseReceiptDataSchema = zod.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) => {
@@ -31215,7 +31217,7 @@ var CreditPurchaseReceiptDataSchema = zod.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"
   ),
@@ -31225,7 +31227,7 @@ var CreditPurchaseReceiptIpfsSchema = NftIpfsSchema.safeExtend({
   schema: NftIpfsSchema.shape.schema.safeExtend({
     type: zod.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,
@@ -31561,7 +31563,7 @@ var CreditRetirementReceiptDataSchema = zod.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,
@@ -31569,7 +31571,7 @@ var CreditRetirementReceiptDataSchema = zod.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,
@@ -31577,7 +31579,7 @@ var CreditRetirementReceiptDataSchema = zod.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) => {
@@ -31702,7 +31704,7 @@ var CreditRetirementReceiptDataSchema = zod.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"
   ),
@@ -31712,7 +31714,7 @@ var CreditRetirementReceiptIpfsSchema = NftIpfsSchema.safeExtend({
   schema: NftIpfsSchema.shape.schema.safeExtend({
     type: zod.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,
@@ -31865,7 +31867,7 @@ var CollectionSchema = BaseIpfsSchema.safeExtend({
   schema: BaseIpfsSchema.shape.schema.safeExtend({
     type: zod.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: zod.z.record(zod.z.string(), zod.z.unknown()).optional().meta({
@@ -31899,7 +31901,7 @@ var CreditSchema = BaseIpfsSchema.safeExtend({
   schema: BaseIpfsSchema.shape.schema.safeExtend({
     type: zod.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: zod.z.record(zod.z.string(), zod.z.unknown()).optional().meta({
@@ -31925,7 +31927,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);
@@ -31935,7 +31937,7 @@ var MethodologyDataSchema = zod.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: zod.z.string().min(50).max(2e3).meta({
     title: "Methodology Description",
@@ -31965,7 +31967,7 @@ var MethodologyDataSchema = zod.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()
 };
@@ -31973,7 +31975,7 @@ var MethodologySchema = BaseIpfsSchema.safeExtend({
   schema: BaseIpfsSchema.shape.schema.safeExtend({
     type: zod.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
@@ -32003,7 +32005,7 @@ var MassIDAuditSummarySchema = zod.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 = zod.z.strictObject({
   methodology: MethodologyReferenceSchema,
@@ -32013,9 +32015,9 @@ var MassIDAuditDataSchema = zod.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"],
@@ -32027,7 +32029,7 @@ var MassIDAuditDataSchema = zod.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"],
@@ -32047,7 +32049,7 @@ var MassIDAuditDataSchema = zod.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()
 };
@@ -32055,7 +32057,7 @@ var MassIDAuditSchema = BaseIpfsSchema.safeExtend({
   schema: BaseIpfsSchema.shape.schema.safeExtend({
     type: zod.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