Address Standardization and Validation Module

{
  "schemaVersion": "1.0",
  "capabilityId": "00000000-0000-4000-8000-00000000000b",
  "name": "Address Standardization and Validation Module",
  "slug": "address-standardization-validation",
  "summary": "Normalizes postal addresses, validates deliverability signals, and returns structured components without retaining inputs.",
  "granularity": "module",
  "purposes": [
    "address validation",
    "data normalization",
    "postal data"
  ],
  "features": [
    "international addresses",
    "normalization",
    "deliverability",
    "no retention"
  ],
  "functionalDescription": "Normalizes postal addresses, validates deliverability signals, and returns structured components without retaining inputs. The versioned contract documents deterministic behavior, failure modes, configuration, and integration boundaries for production teams.",
  "inputs": [
    {
      "name": "request",
      "contentType": "application/json",
      "description": "Validated application/json request payload",
      "required": true
    }
  ],
  "outputs": [
    {
      "name": "result",
      "contentType": "application/json",
      "description": "Typed application/json response with trace metadata",
      "required": true
    }
  ],
  "runtimes": [
    {
      "language": "TypeScript",
      "runtime": "node",
      "versions": [
        "20",
        "22"
      ]
    }
  ],
  "frameworks": [
    "Zod"
  ],
  "deploymentTargets": [
    "aws-lambda",
    "node-service"
  ],
  "dependencies": [
    {
      "name": "zod",
      "version": ">=2",
      "optional": false
    }
  ],
  "permissions": [
    {
      "resource": "temporary-storage",
      "access": "read-write",
      "reason": "Bounded request processing"
    }
  ],
  "dataClassifications": [
    "PII",
    "confidential"
  ],
  "complianceClaims": [
    "SBOM available",
    "Dependency scan recorded"
  ],
  "testEvidence": {
    "coveragePercent": 92,
    "tests": 248,
    "lastRun": "2026-07-20T14:00:00.000Z",
    "status": "passing"
  },
  "securityEvidence": {
    "criticalFindings": 0,
    "highFindings": 0,
    "score": 90,
    "scannedAt": "2026-07-19T09:30:00.000Z",
    "scanner": "FixtureScan 1.4"
  },
  "benchmarks": [
    {
      "name": "p95 latency",
      "value": 166,
      "unit": "ms",
      "environment": "2 vCPU / 2 GB fixture runner"
    }
  ],
  "buildBenchmark": {
    "basis": "fixture-directional",
    "sampleSize": 0,
    "referenceTask": "Reimplement the declared address-standardization-validation contract in a compatible greenfield repository",
    "tokenEstimate": {
      "low": 42000,
      "high": 104000
    },
    "agentTimeMinutes": {
      "low": 34,
      "high": 94
    },
    "humanReviewHours": {
      "low": 0.5,
      "high": 2.1
    },
    "observedAt": null,
    "methodology": "Directional fixture derived from declared granularity and integration effort; no coding-agent replay was run.",
    "confidence": "low",
    "disclosure": "Prototype estimate only. It is not an empirical benchmark and must not be presented as measured savings."
  },
  "integration": {
    "estimatedHours": 2,
    "packageManager": "pnpm",
    "configurationNotes": [
      "Pin the immutable artifact digest",
      "Configure scoped service credentials"
    ]
  },
  "composition": {
    "composable": true,
    "interface": "package-library",
    "compatibleWith": [],
    "requires": [],
    "contractStability": "stable",
    "evidence": "fixture-declared",
    "notes": [
      "Compatibility links are declared fixture metadata and have not been independently integration-tested"
    ]
  },
  "commercialModels": [
    "pay-per-execution",
    "licensed-artifact"
  ],
  "licenseOptions": [
    {
      "id": "evaluation",
      "name": "Private evaluation",
      "scope": "evaluation",
      "priceCents": 5,
      "unit": "evaluation",
      "rights": [
        "evaluation"
      ],
      "developerSeats": null,
      "restrictions": [
        "Non-production use only",
        "Results retained for 30 days"
      ]
    },
    {
      "id": "hosted-execution",
      "name": "Hosted API execution",
      "scope": "execution",
      "priceCents": 20,
      "unit": "execution",
      "rights": [
        "hosted-access",
        "commercial-use"
      ],
      "developerSeats": null,
      "restrictions": [
        "No artifact or source access"
      ]
    },
    {
      "id": "developer",
      "name": "Developer artifact",
      "scope": "individual",
      "priceCents": 19900,
      "unit": "one-time",
      "rights": [
        "artifact-access",
        "commercial-use"
      ],
      "developerSeats": 1,
      "restrictions": [
        "No redistribution",
        "One named developer"
      ]
    }
  ],
  "artifactDigests": [
    {
      "algorithm": "sha256",
      "digest": "ef2eb62bc1df7c12f0c8be2ad14fcd1ee610faaaf2cac8225ac01b392c6ad8d8",
      "artifactType": "package"
    }
  ],
  "provenance": {
    "builder": "FunctionFoundry demo build service",
    "sourceRevision": "fixture-address-standardization-validation-v1",
    "builtAt": "2026-07-18T12:00:00.000Z",
    "signed": true
  },
  "maintenanceStatus": "active",
  "version": "1.11.0",
  "seller": {
    "name": "Canonical Data",
    "verified": true,
    "reputation": 4.5
  },
  "verificationBadges": [
    "Privacy reviewed"
  ]
}